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
Using ADSI to Configure IIS in a C++ Application