次の方法で共有


IVssProviderCreateSnapshotSet::AbortSnapshots メソッド (vsprov.h)

AbortSnapshots メソッドは、このプロバイダーで準備されたシャドウ コピーを中止します。 これには、コミットされていないシャドウ コピーと事前コミットされたシャドウ コピーがすべて含まれます。

構文

HRESULT AbortSnapshots(
  [in] VSS_ID SnapshotSetId
);

パラメーター

[in] SnapshotSetId

シャドウ コピー セットを識別する VSS_ID

戻り値

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

リターン コード/値 Description
S_OK
0x00000000L
操作が正常に完了しました。
E_OUTOFMEMORY
0x8007000EL
メモリ不足またはその他のシステム リソース。
E_INVALIDARG
0x80070057L
パラメーター値の 1 つが無効です。
VSS_E_OBJECT_NOT_FOUND
0x80042308L
SnapshotSetId パラメーターは、見つからなかったオブジェクトを参照します。
VSS_E_PROVIDER_VETO
0x80042306L
予期しないプロバイダー エラーが発生しました。 プロバイダーは、問題を解決する方法に関する情報をユーザーに提供するメッセージをアプリケーション イベント ログに記録する必要があります。

解説

VSS は、要求元が IVssBackupComponents::D oSnapshotSet を呼び出した後にのみ AbortSnapshots を呼び出します。これは、シャドウ コピーが失敗した場合や、この時点より前に中止された場合でもです。 つまり、EndPrepareSnapshots が呼び出されるまで、プロバイダーは AbortSnapshots 呼び出しを受け取りません。 シャドウ コピーが中止されるか、この時点より前に失敗した場合、新しいシャドウ コピーが開始されるまでプロバイダーに指示は表示されません。 このため、プロバイダーは、任意の時点でシーケンス外の IVssHardwareSnapshotProvider::BeginPrepareSnapshot 呼び出しを処理するように準備する必要があります。 このアウトシーケンス呼び出しは、新しいシャドウ コピー作成シーケンスの開始を表し、新しいシャドウ コピー セット ID を持ちます。

要件

   
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー vsprov.h

関連項目

IVssProviderCreateSnapshotSet