IVssProviderCreateSnapshotSet::AbortSnapshots メソッド (vsprov.h)
AbortSnapshots メソッドは、このプロバイダーで準備されたシャドウ コピーを中止します。 これには、コミットされていないシャドウ コピーと事前コミットされたシャドウ コピーがすべて含まれます。
構文
HRESULT AbortSnapshots(
[in] VSS_ID SnapshotSetId
);
パラメーター
[in] SnapshotSetId
シャドウ コピー セットを識別する VSS_ID 。
戻り値
このメソッドは、これらの値のいずれかを返すことができます。
リターン コード/値 | Description |
---|---|
|
操作が正常に完了しました。 |
|
メモリ不足またはその他のシステム リソース。 |
|
パラメーター値の 1 つが無効です。 |
|
SnapshotSetId パラメーターは、見つからなかったオブジェクトを参照します。 |
|
予期しないプロバイダー エラーが発生しました。 プロバイダーは、問題を解決する方法に関する情報をユーザーに提供するメッセージをアプリケーション イベント ログに記録する必要があります。 |
解説
VSS は、要求元が IVssBackupComponents::D oSnapshotSet を呼び出した後にのみ AbortSnapshots を呼び出します。これは、シャドウ コピーが失敗した場合や、この時点より前に中止された場合でもです。 つまり、EndPrepareSnapshots が呼び出されるまで、プロバイダーは AbortSnapshots 呼び出しを受け取りません。 シャドウ コピーが中止されるか、この時点より前に失敗した場合、新しいシャドウ コピーが開始されるまでプロバイダーに指示は表示されません。 このため、プロバイダーは、任意の時点でシーケンス外の IVssHardwareSnapshotProvider::BeginPrepareSnapshot 呼び出しを処理するように準備する必要があります。 このアウトシーケンス呼び出しは、新しいシャドウ コピー作成シーケンスの開始を表し、新しいシャドウ コピー セット ID を持ちます。
要件
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | vsprov.h |