描述
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。 |