IVssComponent::GetPostRestoreFailureMsg メソッド (vswriter.h)

IVssComponent::SetPostRestoreFailureMsg が設定されている場合、GetPostRestoreFailureMsg メソッドは PostRestore イベントの処理中にライターによって生成されたエラーメッセージを返します。

ライターまたはリクエスターは、このメソッドを呼び出すことができます。

構文

HRESULT GetPostRestoreFailureMsg(
  [out] BSTR *pbstrPostRestoreFailureMsg
);

[out] pbstrPostRestoreFailureMsg

PostRestore イベントの処理中に発生したエラーを説明するエラーメッセージを含む文字列へのポインター。

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

値	意味
S_OK	属性値が正常に返されました。
S_FALSE	取得できる PostRestoreFailure メッセージがありませんでした。
E_INVALIDARG	パラメーター値の 1 つが無効です。
E_OUTOFMEMORY	呼び出し元がメモリやその他のシステムリソースを使い切れている。
VSS_E_INVALID_XML_DOCUMENT	XML ドキュメントが無効です。詳細については、イベントログを確認してください。詳細については、「 VSS でのイベントとエラーの処理」を参照してください。

呼び出し元は、SysFreeString を呼び出すことによって、pbstrPostRestoreFailureMsg パラメーターによって保持されているメモリを解放する必要があります。

SetPostRestoreFailureMsg を使用して PostRestore エラーメッセージを設定しなかった場合、GetPreRestoreFailureMsg はS_FALSEを返します。

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