CVssWriterEx2::SetWriterFailureEx メソッド (vswriter.h)
ライターが VSS 操作への参加で問題が発生したことを示す拡張エラー情報を設定します。
構文
HRESULT SetWriterFailureEx(
[in] HRESULT hrWriter,
[in] HRESULT hrApplication,
[in] LPCWSTR wszApplicationMessage
);
パラメーター
[in] hrWriter
要求者に返されるエラー コード。
このメソッドで設定できるエラー コードを次に示します。
| 値 | 意味 |
|---|---|
|
ライターは成功しました。 |
|
シャドウ コピーには、アプリケーション コンポーネントを正しくバックアップするためにライターが必要とするボリュームのサブセットのみが含まれます。 |
|
ライターがメモリやその他のシステム リソースを使い果たしました。 このエラー コードを処理する推奨される方法は、10 分待ってから、操作を最大 3 回繰り返す方法です。 |
|
Freeze イベントと Thaw イベントの間にタイムアウトが発生したため、ライター操作が失敗しました。 このエラー コードを処理する推奨される方法は、10 分待ってから、操作を最大 3 回繰り返す方法です。 |
|
バックアップ、復元、またはシャドウ コピーの作成プロセス全体が再起動された場合に発生しない可能性があるエラーが原因でライターが失敗しました。 このエラー コードを処理する推奨される方法は、10 分待ってから、操作を最大 3 回繰り返す方法です。 |
|
ライター操作は、別のシャドウ コピーが作成された場合に繰り返される可能性があるエラーが原因で失敗しました。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。 |
|
ライターは、1 つ以上のコンポーネント レベルのエラーを報告しています。 エラーを報告するには、ライターで IVssComponentEx2::SetFailure メソッドを使用する必要があります。 |
[in] hrApplication
要求者に返される追加のエラー コード。 このパラメーターは省略可能です。
[in] wszApplicationMessage
要求者がエンド ユーザーに表示するエラー メッセージを含む文字列。 ライターは、このメソッドで使用する前に、必要に応じてこの文字列をローカライズする役割を担います。 このパラメーターは省略可能で、 NULL または空の文字列を指定できます。
戻り値
このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。
注釈
このメソッドは、 CVssWriter::OnIdentify または CVssWriterEx::OnIdentifyEx から呼び出すことはできません。
コンポーネント レベルのエラーを報告するには、ライターは IVssComponentEx2::SetFailure メソッドを使用する必要があります。
ライターのイベント ハンドラー ( CVssWriter::OnFreeze など) がこのメソッドを呼び出す場合は、イベント ハンドラーを呼び出したのと同じスレッドで呼び出す必要があります。 詳細については、「 ライター イベントの処理」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | vswriter.h (Vss.h、VsWriter.h を含む) |
| Library | VssApi.lib |