IVssBackupComponents::RevertToSnapshot メソッド (vsbackup.h)

  • [アーティクル]

RevertToSnapshot メソッドは、ボリュームを以前のシャドウ コピーに戻します。 永続的なコンテキスト (VSS_CTX_APP_ROLLBACK、VSS_CTX_CLIENT_ACCESSIBLE、VSS_CTX_CLIENT_ACCESSIBLE_WRITERS、またはVSS_CTX_NAS_ROLLBACK) で作成されたシャドウ コピーのみがサポートされます。

メモ この方法は、Windows Server オペレーティング システムでのみサポートされています。
 

構文

HRESULT RevertToSnapshot(
  [in] VSS_ID SnapshotId,
  [in] BOOL   bForceDismount
);

パラメーター

[in] SnapshotId

元に戻すシャドウ コピーのVSS_ID。

[in] bForceDismount

このパラメーターが TRUE の場合、ボリュームが使用中であっても、ボリュームはマウント解除され、元に戻されます。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

値 説明
S_OK
 操作に成功しました。
E_ACCESSDENIED
 呼び出し元プロセスに十分な特権がありません。
E_FAIL
 内部エラーが発生しています。
E_INVALIDARG
 渡されたパラメーターの 1 つが無効です。
E_NOTIMPL
 ボリュームのプロバイダーは、元に戻す操作をサポートしていません。
E_OUTOFMEMORY
 呼び出し元がメモリやその他のシステム リソースを使い切れている。
VSS_E_OBJECT_NOT_FOUND
 SnapshotId パラメーターが有効なシャドウ コピーではありません。
VSS_E_PROVIDER_NOT_REGISTERED
 プロバイダーが見つかりませんでした。
VSS_E_REVERT_IN_PROGRESS
 ボリュームには既に元に戻す処理があります。
VSS_E_UNSUPPORTED_CONTEXT
 Revert は、永続的なシャドウ コピーでのみサポートされます。
VSS_E_VOLUME_IN_USE
 bForceDismount パラメーターが FALSE で、ボリュームをロックできませんでした。
VSS_E_VOLUME_NOT_SUPPORTED
 このボリュームでは、Revert はサポートされていません。

解説

この操作を取り消したり、完了したら元に戻したりすることはできません。 元に戻す操作中にコンピューターが再起動された場合、システムの再起動時に元に戻すプロセスが続行されます。

要件

   
サポートされている最小のクライアント サポートなし
サポートされている最小のサーバー Windows Server 2008、Windows Server 2003 SP1 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー vsbackup.h (VsBackup.h、Vss.h、VsWriter.h を含む)
Library VssApi.lib

関連項目

IVssBackupComponents

IVssBackupComponents::QueryRevertStatus