IVssProviderCreateSnapshotSet

IVssProviderCreateSnapshotSet インターフェイスは、シャドウコピーの作成時に使用されるメソッドを提供します。

最後の IVssHardwareSnapshotProvider::BeginPrepareSnapshot 呼び出しの後に、シャドウコピーセット全体に対して 1 回だけ呼び出されます。

これら以外の値が返された場合、VSS はイベントログにイベントを書き込み、そのエラーを VSS_E_UNEXPECTED_PROVIDER_ERROR に変換します。

準備済みの LUN を短時間でコミットできる状態にプロバイダーを整えます。

これら以外の値が返された場合、VSS はイベントログにイベントを書き込み、そのエラーを VSS_E_UNEXPECTED_PROVIDER_ERROR に変換します。

このプロバイダー内のすべての LUN を短時間でコミットします。

これら以外の値が返された場合、VSS はイベントログにイベントを書き込み、そのエラーを VSS_E_UNEXPECTED_PROVIDER_ERROR に変換します。

このメソッドは、シャドウコピーを取得すべき時点として定められたタイミングで呼び出されます。プロバイダーは、このシャドウコピーセット内で 準備済みの各 LUN について、その時点の LUN の内容を永続化するために必要な処理を行います。 このメソッドの実行中は、アプリケーションと I/O サブシステムの大部分が静止した状態になります。そのため、プロバイダーは このメソッドに費やす時間を最小限に抑える必要があります。原則として、このメソッドは 1 秒未満で完了すべきです。 このメソッドは Flush and Hold のウィンドウ内で呼び出され、VSS カーネルサポートは 10 秒以内に解放が 行われない場合に Flush and Hold をキャンセルします。その結果、VSS はシャドウコピーの作成処理を失敗させます。 各プロバイダーがこの呼び出しの完了に 1 ～ 2 秒を超える時間を要する場合、シャドウコピーの作成全体が失敗する可能性が 高くなります。

I/O システムが静止しているため、プロバイダーは I/O を一切発行しないよう注意する必要があります。I/O を発行すると システムがデッドロックするおそれがあります。たとえば、このメソッド内やこのメソッドから呼び出される処理でのデバッグ出力や トレース用の I/O が該当します。なお、メモリマップトファイルおよびページング I/O は、この時点では凍結されません。

I/O システムが静止しているのは、このメソッドの実行中だけである点に注意してください。最後のプロバイダーの CommitSnapshots メソッドが戻った直後に、VSS サービスはソース LUN に対する保留中の書き込みをすべて解放します。プロバイダーがソース LUN とシャドウコピー LUN の同期処理を行う場合、その同期はプロバイダーの CommitSnapshots メソッドが戻る前に完了していなければならず、非同期に実行することはできません。

シャドウコピーセットに関与するすべてのプロバイダーが CommitSnapshots に成功した後に呼び出されます。

これら以外の値が返された場合、VSS はイベントログにイベントを書き込み、そのエラーを VSS_E_UNEXPECTED_PROVIDER_ERROR に変換します。

プロバイダーが自動回復 (auto-recover) シャドウコピーをサポートできるようにします。

これら以外の値が返された場合、VSS はイベントログにイベントを書き込み、そのエラーを VSS_E_UNEXPECTED_PROVIDER_ERROR に変換します。

このメソッドは、Windows Server 2003 Service Pack 1 (SP1) で 自動回復 (auto-recover) 機能が導入された際に、 バイナリ互換性を確保する目的で追加されました。

HRESULT PreFinalCommitSnapshots(
VSS_ID     /* SnapshotSetId */
)
{
    return S_OK;
}

自動回復 (auto-recover) シャドウコピーをサポートします。

これら以外の値が返された場合、VSS はイベントログにイベントを書き込み、そのエラーを VSS_E_UNEXPECTED_PROVIDER_ERROR に変換します。

このメソッドは、Windows Server 2003 Service Pack 1 (SP1) で 自動回復 (auto-recover) 機能が導入された際に、 バイナリ互換性を確保する目的で Windows Server 2003 に追加されました。

HRESULT PostFinalCommitSnapshots(
    VSS_ID     /* SnapshotSetId */
)
{
    return S_OK;
}

このプロバイダー内で準備済みのシャドウコピーを中止します。

このメソッドは、次のいずれかの値を返すことがあります。

VSS が AbortSnapshots を呼び出すのは、 リクエスターが IVssBackupComponents::DoSnapshotSet を 呼び出した後だけです。これは、その時点より前にシャドウコピーが失敗または中止された場合でも同様です。つまり、プロバイダーが AbortSnapshots の呼び出しを受け取るのは、 EndPrepareSnapshots が 呼び出された後に限られます。それより前にシャドウコピーが中止または失敗した場合、プロバイダーには新しいシャドウコピーが 開始されるまで何の通知も行われません。このため、プロバイダーは順序どおりでない IVssHardwareSnapshotProvider::BeginPrepareSnapshot の 呼び出しを、任意のタイミングで処理できるようにしておく必要があります。この順序どおりでない呼び出しは、新しいシャドウコピー作成シーケンスの 開始を表し、新しいシャドウコピーセット ID を伴います。