IVssBackupComponentsEx2::BreakSnapshotSetEx メソッド (vsbackup.h)

  • [アーティクル]

要求者が指定したオプションに従ってシャドウ コピー セットを中断します。

構文

HRESULT BreakSnapshotSetEx(
  [in]  VSS_ID    SnapshotSetID,
  [in]  DWORD     dwBreakFlags,
  [out] IVssAsync **ppAsync
);

パラメーター

[in] SnapshotSetID

シャドウ コピー セット識別子。

[in] dwBreakFlags

シャドウ コピー セットの破損方法を指定する _VSS_HARDWARE_OPTIONS フラグのビットマスク。

[out] ppAsync

シャドウ コピー セットの中断操作の状態を取得するために使用できる IVssAsync インターフェイス ポインターを受け取る変数へのポインター。 中断操作が完了したら、このインターフェイス ポインターに対して IUnknown::Release メソッドを呼び出す必要があります。

戻り値

このメソッドの有効なリターン コードを次に示します。

値 説明
S_OK
0x000000000L
 シャドウ コピー セットが正常に切断されました。
E_ACCESSDENIED
0x80070005L
 呼び出し元に十分な特権がないか、管理者ではありません。
E_INVALIDARG
0x80070057L
 パラメーター値の 1 つが無効です。
E_OUTOFMEMORY
0x8007000EL
 呼び出し元がメモリ不足またはその他のシステム リソースです。
VSS_E_BREAK_REVERT_ID_FAILED
0x800423F6L
 1 つ以上の宛先 LUN の MBR ディスク署名、GPT ディスク識別子、または GPT パーティション識別子を元の LUN に戻すことができなかったため、シャドウ コピー セットの中断操作が失敗しました。 1 つ以上の元の LUN がコンピューター上でマスクされていない場合、中断操作によって署名の競合が発生します。
VSS_E_OBJECT_NOT_FOUND
0x80042308L
 指定されたシャドウ コピーが存在しません。
VSS_E_PROVIDER_VETO
0x80042306L
 シャドウ コピーはソフトウェア プロバイダーによって作成され、破損することはできません。
VSS_E_UNEXPECTED
 予期しないエラー。 エラー コードはエラー ログ ファイルに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。

Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 および Windows 7 まではサポートされません。 代わりに、E_UNEXPECTEDが使用されます。

解説

BreakSnapshotSetEx は IVssBackupComponents::BreakSnapshotSet メソッドに似ていますが、状態を照会し、シャドウ コピー セットの破損方法を指定するための追加のパラメーターがある点が異なります。

BreakSnapshotSet と同様に、BreakSnapshotSetEx は、ハードウェア シャドウ コピー プロバイダーによって作成されたシャドウ コピーにのみ使用できます。

このメソッドが返された後も、シャドウ コピー ボリュームは引き続きボリュームですが、シャドウ コピーではなくなります。 詳細については、「 シャドウ コピーの中断」を参照してください。

要件

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