IWbemBackupRestore：：Restore 方法 (wbemcli.h)

IWbemBackupRestore：：Restore 方法會刪除目前存放庫的內容，並使用先前指定的備份內容加以還原。

因為 Windows Management Instrumentation (WMI) 是這個介面的伺服器，而且必須停止才能順利完成此作業，所以如果此呼叫成功，COM 連線就會中斷。

語法

HRESULT Restore(
  [in] LPCWSTR strRestoreFromFile,
  [in] long    lFlags
);

參數

[in] strRestoreFromFile

常數，以 Null 結尾的 16 位 Unicode 字元字串，其中包含要還原之檔案的檔名。 指定的檔案應該指向先前使用 IWbemBackupRestore：：Backup 建立的檔案。

[in] lFlags

下列其中一個旗標來自 WBEM_BACKUP_RESTORE_FLAGS 列舉。

WBEM_FLAG_BACKUP_RESTORE_DEFAULT

不會關閉作用中的用戶端;如果有的話，會傳回錯誤。

WBEM_FLAG_BACKUP_RESTORE_FORCE_SHUTDOWN

關閉任何作用中的用戶端。

傳回值

這個方法會傳回 HRESULT ，指出方法呼叫的狀態。 下列清單列出 HRESULT 中包含的值。

備註

默認模式與設定強制模式旗標相同，這會中斷所有作用中的連線。 這會導致遠端過程調用 (RPC) 從作用中 COM 連線到 WMI 的錯誤，直到建立新的連線為止。

範例

下列 C++ 範例示範如何呼叫 IWbemBackupRestore：：Restore 方法。

// The pInt variable is of type IWbemBackupRestore*
pInt->Restore(
        L"c:\\\\Windows\\System32\\wbem\\repository\\back.x",
        WBEM_FLAG_BACKUP_RESTORE_FORCE_SHUTDOWN
      );

規格需求