Share via

IMSAdminBase::Restore

  • Article

The IMSAdminBase::Restore method restores the metabase from a backup. The restore operation stops all services dependent on IISADMIN, including all servers, until the restore has completed, then restarts all services. You should plan for this service interruption when restoring the metabase from a backup.

HRESULT Restore(
      LPCWSTR pszMDBackupLocation,
      DWORD dwMDVersion,
      DWORD dwMDFlags
);

Parameters

  • pszMDBackupLocation
    A string of up to MD_BACKUP_MAX_LEN Unicode characters that identifies the backup location containing the backup to be restored.

  • dwMDVersion
    Specifies the version number of the backup to be restored from the backup location, or can be the following constant:

    Constant

    Description

    MD_BACKUP_HIGHEST_VERSION

    Restore from the highest existing backup version in the specified backup location.

  • dwMDFlags
    Reserved. Must be zero.

Return Values

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

Value

Description

E_INVALIDARG

An argument was invalid.

HRESULT_FROM_WIN32(ERROR_INVALID_DATA)

The data is invalid.

HRESULT_FROM_WIN32(ERROR_NOT_ENOUGH_MEMORY)

Insufficient memory to perform the operation.

S_OK

The method succeeded.

MD_ERROR_INVALID_VERSION

The specified version is invalid.

MD_WARNING_INVALID_DATA

Invalid metabase data.

MD_WARNING_PATH_NOT_FOUND

The specified path was not found.

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.