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

  • [アーティクル]

VSS 要求者は、このメソッドを呼び出して、ライターによって報告されたコンポーネント レベルのエラーを取得します。

構文

HRESULT GetFailure(
  [out] HRESULT *phr,
  [out] HRESULT *phrApplication,
  [out] BSTR    *pbstrApplicationMessage,
  [out] DWORD   *pdwReserved
);

パラメーター

[out] phr

ライターが IVssComponentEx2::SetFailure メソッドの hr パラメーターに渡した HRESULT エラー コードを受け取る呼び出し元によって割り当てられた変数のアドレス。 このパラメーターは必須であり、 NULL にすることはできません。

サポートされている値を次に示します。

値 意味
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 でのイベントとエラーの処理」を参照してください。
VSS_E_WRITER_NOT_RESPONDING
 ライターが応答していません。
VSS_E_WRITER_STATUS_NOT_AVAILABLE
 ライターの状態は、1 つ以上のライターでは使用できません。 ライターが、使用可能なバックアップおよび復元セッションの最大数に達している可能性があります。

[out] phrApplication

SetFailure メソッドの hrApplication パラメーターにライターが渡したリターン コードを受け取る呼び出し元によって割り当てられた変数のアドレス。 このパラメーターは必須であり、 NULL にすることはできません。

[out] pbstrApplicationMessage

SetFailure メソッドの wszApplicationMessage パラメーターにライターが渡したアプリケーションエラー メッセージを受け取る呼び出し元によって割り当てられた変数のアドレス。 このパラメーターは必須であり、 NULL にすることはできません。

[out] pdwReserved

呼び出し元によって割り当てられた DWORD 変数のアドレス。 このパラメーターは今後使用するために予約されていますが、必須であり、 NULL にすることはできません。

戻り値

このメソッドの有効なリターン コードを次に示します。

値 意味
S_OK
0x000000000L
 指定したライターの状態が正常に返されました。 ライターが成功したことを確認するには、 phrFailureWriter パラメーターの値を確認する必要があることに注意してください。 ライター エラー コードは、VsWriter.h および ライター エラーと Vetoes に記載されているものの中に含めることができます。
E_INVALIDARG
0x80070057L
 phr、phrApplication、pbstrApplicationMessage、または pdwReserved パラメーターが NULL です。
E_OUTOFMEMORY
0x8007000EL
 呼び出し元がメモリ不足またはその他のシステム リソースです。
VSS_E_BAD_STATE
0x80042301L
 バックアップ コンポーネント オブジェクトが初期化されていないか、復元操作中にこのメソッドが呼び出されたか、このメソッドが正しいシーケンス内で呼び出されていません。

注釈

呼び出し元は、このメソッドによって返される状態情報へのアクセスが完了したら、 SysFreeString を呼び出して 、pbstrApplicationMessage パラメーターによって保持されているメモリを解放する必要があります。

要件

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

こちらもご覧ください

IVssComponentEx2