勇芳软件工作室.汉化:  Windows Management Instrumentation > COM API for WMI > Interfaces > IWbemBackupRestore >

Restore Method

Previous pageReturn to chapter overviewNext page

描述

 

IWbemBackupRestore.Restore方法删除当前存储库的内容,并使用先前指定的备份的内容将其还原。

 

由于Windows Management Instrumentation(WMI)是此接口的服务器,必须停止以成功完成此操作,否则如果此调用成功,则COM连接将中断。

 

C++ 语法

 

HRESULT Restore(

[in]  LPCWSTR strRestoreFromFile,

[in]  long lFlags

);

 

PowerBASIC 语法

 

METHOD Restore ( _

BYREF strRestoreFromFile AS WSTRINGZ, _

BYVAL lFlags AS LONG _

) AS LONG

 

参数

 

strRestoreFromFile

 

包含要还原的文件的文件名的16位Unicode字符的常量,以null结尾的字符串。指定的文件应指向以前使用IWbemBackupRestore.Backup创建的文件。

 

lFlags

 

整数,包含以下标志之一。

 

含义

WBEM_FLAG_BACKUP_

RESTORE_DEFAULT

不关闭活动客户端;如果有的话返回错误。

WBEM_FLAG_BACKUP_

RESTORE_FORCE_SHUTDOWN

关闭任何活动的客户端。

 

返回值

 

此方法返回一个HRESULT,表示方法调用的状态。下表列出了HRESULT中包含的值。

 

退货代码

描述

WBEM_E_BACKUP_

RESTORE_WINMGMT_RUNNING

标志设置为WBEM_FLAG_BACKUP_RESTORE_DEFAULT时发生,并且有活动的客户端。

WBEM_E_INVALID_PARAMETER

其中一个论点是无效的。

WBEM_E_ACCESS_DENIED

用户没有权利执行此操作。有关详细信息,请参阅维护WMI安全.

S_OK

方法成功。

 

示例代码

 

以下C ++示例显示如何调用IWbemBackupRestore.Restore方法。

 

// The pInt variable is of type IWbemBackupRestore*

pInt->Restore(

      L"c:\\\\winnt\\system32\\wbem\\repository\\back.x",

      WBEM_FLAG_BACKUP_RESTORE_FORCE_SHUTDOWN

    );

 

备注

 

Windows Server 2003和Windows XP: 默认模式与设置强制模式标志相同,该标志会中断所有活动连接。这将导致从活动COM连接到WMI —的远程过程调用(RPC)错误,直到建立新的连接。

 

要求

 

客户

需要Windows Vista,Windows XP,Windows 2000 Professional,Windows NT Workstation 4.0 SP4及更高版本,Windows Me,Windows 98或Windows 95。

服务器

需要Windows Server 2008,Windows Server 2003,Windows 2000 Server或Windows NT Server 4.0 SP4及更高版本。

在Wbemcli.inc中声明。

DLL

需要Wbemsvc.dll。