Share via


IISComputer::EnumBackups

The EnumBackups method enumerates metabase backups stored in one or more backup locations, retrieving the ___location, version number, and date of each backup.

HRESULT EnumBackups(
  BSTR  bstrLocation,
  LONG  lIndex,
  VARIANT*  pvVersion,
  VARIANT*  pvLocations,
  VARIANT*  pvDate
);

Parameters

  • bstrLocation
    [in] String containing the ___location. If an empty string is specified, all backup locations will be searched.

  • lIndex
    [in] Long integer containing the index of the backup to enumerate. Start the index at 0 and increment by 1 until MD_ERROR_DATA_NOT_FOUND (0x800CC801L) is returned. This constant is defined in the Mdmsg.h header file.

  • pvVersion
    [out] Pointer to a VARIANT containing the version number of the backup enumerated.

  • pvLocations
    [out] Pointer to a VARIANT containing the backup ___location of the backup enumerated.

  • pvDate
    [out] Pointer to a VARIANT containing the date and time of the backup, in Coordinated Universal Time (UTC), formerly GMT (Greenwich Mean Time).

Requirements

Client: Requires Windows XP Professional, Windows 2000 Professional, or Windows NT Workstation 4.0.

Server: Requires Windows Server 2003, Windows 2000 Server, or Windows NT Server 4.0.

Product: IIS

Header: Declared in iiisext.h; include iisext_i.c.

Return Value

Returns an HRESULT that contains one of the following values, or any errors from the file system converted to HRESULT.

Term

Definition

HRESULT_FROM_WIN32(ERROR_INVALID_NAME)

Specified name is invalid.

HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)

No more items to enumerate.

HRESULT_FROM_WIN32(ERROR_NOT_ENOUGH_MEMORY)

Insufficient memory to perform the operation.

S_OK

The method succeeded.

See Also

Concepts

IIS ADSI Provider Interfaces

Using ADSI to Configure IIS in a C++ Application

IIS Constants and Header Files

IISComputer2 Interface

IMSAdminBase

IMSAdminBase2