IWbemBackupRestoreEx

IWbemBackupRestoreEx インターフェイスは、リポジトリの内容のバックアップと復元を行います。

既定のモードは強制モードフラグを設定した場合と同じであり、アクティブなすべての接続を切断します。そのため、新しい接続が確立されるまで、WMI へのアクティブな COM 接続からはリモートプロシージャコール (RPC) エラーが発生します。

復元操作の実行中は、リポジトリへのアクティブな接続が存在してはなりません。このため、既定のパラメーターを使用していてアクティブな接続がある場合、復元操作は失敗します。アクティブなすべての接続を切断するフラグを指定することもできます。

呼び出しを行うクライアントは、適切な特権が有効になっている必要があります。バックアップには SE_RESTORE_NAME 特権が必要であり、復元にも SE_RESTORE_NAME が必要です。特権を有効にするには、クライアントアプリケーションがその特権を持つユーザーアカウントで実行されており、かつ Windows の AdjustTokenPrivileges 関数を使用して特権を有効にする必要があります。

これらの呼び出しはローカルユーザーであれば誰でも実行できますが、リモートユーザーは root 名前空間に対する WBEM_FULL_WRITE_REP アクセス権を持っている必要があります。

IWbemBackupRestoreEx::Pause メソッドは、Windows Management Instrumentation (WMI) リポジトリへの書き込み操作をロックアウトします。読み取り操作がブロックされる場合もあります。

このメソッドは、メソッド呼び出しの状態を示す HRESULT を返します。次の一覧は、HRESULT に含まれる値を示しています。

Pause メソッドを実装する場合は、できるだけ早く Resume メソッドを呼び出してください。Resume が 15 分以内に呼び出されない場合は、自動的に呼び出されます。Resume を呼び出さずに同一オブジェクトに対して Pause を 2 回呼び出すと失敗します。2 つのオブジェクトに対して同時に Pause を呼び出すと、最初のオブジェクトで Resume が呼び出されるまで 2 番目のオブジェクトがロックされる可能性があります。

使用例

次の C++ の例は、IWbemBackupRestoreEx::Pause メソッドを正しく呼び出す方法を示しています。

// The pInt variable is of type IWbemBackupRestoreEx*
pInt->Pause();

IWbemBackUpRestoreEx::Resume メソッドは、Windows Management Instrumentation (WMI) リポジトリのロックを解放し、操作を続行できるようにします。

このメソッドは、メソッド呼び出しの状態を示す HRESULT を返します。次の一覧は、HRESULT に含まれる値を示しています。

Pause メソッドを呼び出した場合は、必ず Resume メソッドを呼び出す必要があります。Resume は、Pause メソッドを実装した IWbemBackUpRestoreEx と同じインスタンスに対して呼び出す必要があります。Resume を呼び出さずにオブジェクトを解放すると、Resume メソッドが自動的に実行されます。

使用例

次の C++ の例は、IWbemBackUpRestoreEx::Resume メソッドを呼び出す方法を示しています。

// The pInt variable is of type IWbemBackupRestoreEx*
pInt->Resume();