IVssComponentEx2::SetFailure メソッド (vswriter.h)

  • [アーティクル]

VSS ライターはこのメソッドを呼び出して、コンポーネント レベルでエラーを報告します。

構文

HRESULT SetFailure(
  [in] HRESULT hr,
  [in] HRESULT hrApplication,
  [in] LPCWSTR wszApplicationMessage,
  [in] DWORD   dwReserved
);

パラメーター

[in] hr

IVssComponentEx2::GetFailure メソッドを呼び出すリクエスターに返されるエラー コード。

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

値 説明
S_OK
 ライターは成功しました。
VSS_E_WRITERERROR_INCONSISTENTSNAPSHOT
 シャドウ コピーには、アプリケーション コンポーネントを正しくバックアップするためにライターが必要とするボリュームのサブセットのみが含まれます。
VSS_E_WRITERERROR_OUTOFRESOURCES
 ライターがメモリやその他のシステム リソースを使い果たしました。 このエラー コードを処理する推奨される方法は、10 分待ってから、操作を最大 3 回繰り返す方法です。
VSS_E_WRITERERROR_TIMEOUT
 Freeze イベントと Thaw イベントの間にタイムアウトが発生したため、ライター操作が失敗しました。 このエラー コードを処理する推奨される方法は、10 分待ってから、操作を最大 3 回繰り返す方法です。
VSS_E_WRITERERROR_RETRYABLE
 バックアップ、復元、またはシャドウ コピーの作成プロセス全体が再起動された場合に発生しない可能性があるエラーが原因でライターが失敗しました。 このエラー コードを処理する推奨される方法は、10 分待ってから、操作を最大 3 回繰り返す方法です。
VSS_E_WRITERERROR_NONRETRYABLE
 ライター操作は、別のシャドウ コピーが作成された場合に繰り返される可能性があるエラーが原因で失敗しました。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。

[in] hrApplication

要求者に返される追加のエラー コード。 このパラメーターは省略可能です。

[in] wszApplicationMessage

要求者がエンド ユーザーに表示するエラー メッセージを含む文字列。 ライターは、このメソッドで使用する前に、必要に応じてこの文字列をローカライズする役割を担います。 このパラメーターは省略可能で、 NULL または空の文字列を指定できます。

[in] dwReserved

このパラメーターは将来使用するために予約されており、0 に設定する必要があります。

戻り値

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

解説

このメソッドの呼び出しに加えて、 CVssWriterEx2::SetWriterFailureEx メソッドを使用して、部分ライターエラーが発生したことを報告します。

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

要件

   
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー vswriter.h

関連項目

IVssComponentEx2