CVssWriter::GetCurrentSnapshotSetId メソッド (vswriter.h)
GetCurrentSnapshotSetId メソッドは、シャドウ コピー セットの一意識別子を返します。
GetCurrentSnapshotSetId は、 CVssWriter 基本クラスによって実装される保護されたメソッドです。
構文
VSS_ID GetCurrentSnapshotSetId();
戻り値
このメソッドは、現在のシャドウ コピー セットの VSS_ID 値を返します。
GetCurrentSnapshotSetId によって返されるシャドウ コピー セット ID は、ライターが現在参加しているバックアップ操作のシャドウ コピー セット ID です。
ライターは、特定の時点で複数のバックアップ操作に関与する可能性があることに注意してください。 したがって、このメソッドがバックアップ シーケンスの一部として呼び出されない場合、つまりイベント ハンドラーから呼び出されない場合、シャドウ コピー セット ID が返される予測できません。
GetCurrentSnapshotSetId がバックアップ シーケンスの一部として呼び出される場合 (たとえば、CVssWriter::OnFreeze、CVssWriter::OnThaw、または CVssWriter::OnPostSnapshot 内から)、VSS インフラストラクチャは、返されるVSS_ID値が現在のバックアップ操作をサポートするシャドウ コピーの値であることを保証します。
ただし、これは BackupShutdown イベント ハンドラー CVssWriter::OnBackupShutdown 内からの GetCurrentSnapshotSetId の呼び出しでは言えません。 リクエスターの突然のシャットダウンのために BackupShutdown イベントが呼び出された場合、 返されるVSS_ID は、ライターが参加していた別のバックアップ操作のイベントである可能性があります。
CVssWriter::OnPostSnapshot が返された後に GetCurrentSnapshotSetId を呼び出すことはできません。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | vswriter.h (Vss.h、VsWriter.h を含む) |
Library | VssApi.lib |