CVssWriter::OnPostRestore メソッド (vswriter.h)

  • [アーティクル]

OnPostRestore メソッドは、PostRestore イベントの後にライターによって呼び出されます。 ファイルがリクエスターによってディスクに復元された後に、必要と見なされる操作を実行するために使用されます。 ただし、これらの操作では、バックアップ コンポーネント ドキュメントを変更できません。

OnPostRestore は仮想メソッドです。 これは CSVsWriter 基底クラスによって実装されますが、派生クラスによってオーバーライドできます。

構文

bool OnPostRestore(
  [in] IVssWriterComponents *pComponent
);

パラメーター

[in] pComponent

ライターのコンポーネント情報へのアクセスをメソッドに提供するために VSS によって渡される IVssWriterComponents オブジェクトへのポインター。 リクエスターがコンポーネントをサポートしていない場合 (CSVsWriter::AreComponentsSelected が false を返す場合)、このパラメーターの値は NULL になる可能性があります。

戻り値

基本クラスによって実装されているように、 OnPostRestore は 常に true を返します。

致命的なエラーが発生した場合を除き、このメソッドの他の実装は true を返す必要があります。 致命的なエラーが発生した場合、メソッドは CSVsWriter::SetWriterFailure メソッドを呼び出して、 false を返す前にエラーの説明を提供する必要があります。 致命的でないエラーが発生した場合でも、メソッドは SetWriterFailure を 呼び出しますが 、true を返します。 一時的な問題が原因でエラーが発生した場合、メソッドは SetWriterFailure の呼び出しでVSS_E_WRITERERROR_RETRYABLEを指定する必要があります。

エラーが発生した場合、メソッドはイベント ログにイベントを書き込み、エラーの正確な理由を報告する必要があります。

注釈

CVssWriter 基本クラスによるこのメソッドの既定の実装は、他の操作を実行せずに true を返します。

必要に応じて、ライターは一時ファイルを削除し、復元に参加するために必要なすべてのシステム リソースを解放する必要があります。

ライターは、このメソッドまたは他の CSVSWriter(Ex)::OnXxx コールバック メソッドから例外をスローしないでください。

PostRestore イベントの生成に伴い、リクエスターのバックアップ コンポーネント ドキュメントは読み取り専用ドキュメントになります。 したがって、OnPostRestore のユーザー実装では、インターフェイス (たとえば、IVssComponent::SetRestoreMetadata の呼び出し) を介してドキュメントを変更しようとすると失敗します。

このメソッドが CVssWriterEx2::GetSessionId、 CVssWriter::SetWriterFailure、または CVssWriterEx2::SetWriterFailureEx メソッドを呼び出す場合は、このメソッドを呼び出したのと同じスレッドで呼び出す必要があります。 詳細については、「 ライター イベント処理」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー vswriter.h (Vss.h、VsWriter.h を含む)
Library VssApi.lib

こちらもご覧ください

CSVSWriter

IVssWriterComponents