IVssComponentEx::GetPostSnapshotFailureMsg メソッド (vswriter.h)

ライターが特定のコンポーネントに対して設定した PostSnapshot エラーメッセージ文字列を返します。

ライターと要求者の両方がこのメソッドを呼び出すことができます。ライターは、 IVssBackupComponents::D OSnapshotSet 非同期操作が完了した後に、このメソッドを呼び出す必要があります。

構文

HRESULT GetPostSnapshotFailureMsg(
  [out] BSTR *pbstrFailureMsg
);

[out] pbstrFailureMsg

PostSnapshot イベントの処理中に発生したエラーを説明するエラーメッセージを含む、null で終わるワイド文字列へのポインター。

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

値	説明
S_OK	エラーメッセージが正常に取得されました。
S_FALSE	コンポーネントに対して PostSnapshot エラーメッセージが設定されませんでした。
E_INVALIDARG	パラメーター値の 1 つが無効です。
E_OUTOFMEMORY	呼び出し元がメモリやその他のシステムリソースを使い切れている。

呼び出し元は、sysFreeString 関数を呼び出すことによって、pbstrFailureMsg パラメーターが指す文字列を解放します。


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