IMSAdminBase::EnumBackups

The IMSAdminBase::EnumBackups method enumerates the metabase backups in a specified backup location, or in all backup locations. Repeated calls to this method, increasing dwMDEnumIndex from 0, will return information for each metabase backup in the backup location until HRESULT_FROM_WIN32 (HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)) is returned.

HRESULT EnumBackups(
      LPWSTR pszMDBackupLocation,
      DWORD __RPC_FAR* pdwMDVersion,
      PFILETIME pftMDBackupTime,
      DWORD dwMDEnumIndex
);

Parameters

• pszMDBackupLocation
  On input, a buffer of length MD_BACKUP_MAX_LEN times sizeof(WChar) containing an empty string or a string of up to MD_BACKUP_MAX_LEN Unicode characters that identifies the backup location. If an empty string is input, the method will enumerate backups in all backup locations, returning the backup location in this parameter. If a backup location is specified on input, only backups in the specified backup location will be enumerated.

• pdwMDVersion
  Receives the version number of the backup.

• pftMDBackupTime
  Receives the date and time of the backup, in Universal Time Coordinate (UTC), formerly GMT (Greenwich Mean Time).

• dwMDEnumIndex
  Specifies the index number of the backup to be enumerated.

Return Values

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

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 iadmw.h; include iiscnfg.h.