共用方式為


IISComputer::Restore

The 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(
  BSTR  bstrLocation,
  LONG  lVersion,
  LONG  lFlags
);

Parameters

  • bstrLocation
    [in] String containing the location. If an empty string is specified, the default backup location will be used.

  • lVersion
    [in] Long integer containing the version number to be assigned to the backup. Must be less than or equal to MD_BACKUP_MAX_VERSION (9999). Can be set to MD_BACKUP_NEXT_VERSION (0xffffffff) which automatically selects the next available version number. These constants are defined in the Mddefw.h header file.

  • lFlags
    [in] Reserved. Must be zero.

Return Value

Returns an HRESULT that contains one of the values listed in the table below. The errors that begin with "MD_" are owned by IIS and are defined in the Mdmsg.h header file. 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.

Term

Definition

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 (0x800CC802L).

MD_WARNING_INVALID_DATA

Invalid metabase data (0x000CC805L).

MD_WARNING_PATH_NOT_FOUND

The specified path was not found (0x000CC803L).

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.

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