IMSAdminBase::Backup

The IMSAdminBase::Backup method backs up the metabase to a backup location you specify by providing a backup location name of up to 100 characters in length. Multiple metabase backups can be stored in a backup location.

Note  IIS determines the backup storage mechanism, so the backup location name you provide does not necessarily translate to a particular directory, file, or database storage mechanism. As implemented in this release, metabase backups are stored as files in the SYSTEM32\INETSRV\METABACK directory. This mechanism may change in future releases.

HRESULT Backup( 
  LPCWSTR pszMDBackupLocation, 
  dwMDVersion, 
  dwMDFlags 
); 
 

Parameters

pszMDBackupLocation

A string of up to MD_BACKUP_MAX_LEN unicode characters that identifies the backup location. The storage mechanism will be determined by IIS. If an empty string is specified, the default backup location will be used.

dwMDVersion

Specifies the version number to be assigned to the backup. Must be less than or equal to MD_BACKUP_MAX_VERSION. Can be set to one of the following values:

MD_BACKUP_HIGHEST_VERSION	Overwrite the highest existing backup version in the specified backup location.
MD_BACKUP_NEXT_VERSION	Use the next backup version number available in the specified backup location.

dwMDFlags

One or more of the following flags:

MD_BACKUP_FORCE_BACKUP	Force the backup even if the SaveData operation specified by MD_BACKUP_SAVE_FIRST fails.
MD_BACKUP_OVERWRITE	Back up even if a backup of the same name and version exists in the specified backup location, overwriting it if necessary.
MD_BACKUP_SAVE_FIRST	Perform a SaveData operation before the backup.

Return Values

Returns an HRESULT that contains one of the values listed in the table below. Other errors may also be returned that are passed through from the file system, or from a crypto api when secure metabase data is being saved.