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

  • [アーティクル]

SetWriterFailure メソッドは、このライターがエラー条件を検出し、エラー条件を設定することを示します。

SetWriterFailure は、 CVssWriter 基本クラスによって実装される保護されたメソッドです。

構文

HRESULT SetWriterFailure(
  [in] HRESULT hr
);

パラメーター

[in] hr

設定するエラー コード。 このメソッドで設定できるエラー コードを次に示します。

値 説明
VSS_E_WRITERERROR_INCONSISTENTSNAPSHOT
 シャドウ コピーには、アプリケーション コンポーネントを正しくバックアップするために必要なボリュームのサブセットのみが含まれます。
VSS_E_WRITERERROR_NONRETRYABLE
 別のシャドウ コピーが作成された場合に発生する可能性のあるエラーが原因でライターが失敗しました。
VSS_E_WRITERERROR_OUTOFRESOURCES
 リソース割り当てエラーが原因でライターが失敗しました。
VSS_E_WRITERERROR_RETRYABLE
 バックアップ、復元、またはシャドウ コピーの作成プロセス全体が再起動された場合に発生しない可能性があるエラーが原因でライターが失敗しました。
VSS_E_WRITERERROR_TIMEOUT
 フリーズ状態と解凍状態の間の時間が、CVssWriter::Initialize で設定されたタイムアウト値 (dwTimeoutFreeze) を超えたため、ライターはシャドウ コピーの作成を完了できませんでした。

戻り値

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

このメソッドは、 CVssWriter::OnIdentify または CVssWriterEx::OnIdentifyEx から呼び出すことはできません。

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

要件

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

関連項目

CVssWriter

IVssBackupComponents::GetWriterStatus