IVssBackupComponents::GatherWriterStatus メソッド (vsbackup.h)

[アーティクル]
03/13/2024

GatherWriterStatus メソッドは、各ライターにステータスメッセージの送信を求めます。

構文

HRESULT GatherWriterStatus(
  [out] IVssAsync **pAsync
);

パラメーター

[out] pAsync

ライターの状態データを含む IVssAsync オブジェクトへの二重間接ポインター。

戻り値

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

値	意味
S_OK	IVssAsync インターフェイスのインスタンスへのポインターが正常に返されました。 pHrResult パラメーターによって返される有効な値については、「IVssAsync::QueryStatus」を参照してください。
E_ACCESSDENIED	呼び出し元が十分なバックアップ特権を持っていないか、管理者ではありません。
E_INVALIDARG	ppAsync は有効なポインターを指していません。つまり、 NULL です。
E_OUTOFMEMORY	呼び出し元がメモリやその他のシステムリソースを使い切れている。
VSS_E_BAD_STATE	バックアップコンポーネントオブジェクトが初期化されていないか、復元操作中にこのメソッドが呼び出されたか、このメソッドが正しいシーケンス内で呼び出されていません。
VSS_E_UNEXPECTED	予期しないエラー。エラーコードは、エラーログファイルに記録されます。詳細については、「 VSS でのイベントとエラーの処理」を参照してください。 Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 と Windows 7 まではサポートされません。代わりに E_UNEXPECTED が使用されます。
VSS_E_WRITER_INFRASTRUCTURE	ライターインフラストラクチャが正しく動作していません。イベントサービスと VSS が開始されていることを確認し、それらのサービスに関連するエラーをエラーログにチェックします。

注釈

このメソッドの呼び出し元は、各ライターの状態を受信した後、 IVssBackupComponents::FreeWriterStatus も呼び出す必要があります。

BackupComplete を呼び出した後、リクエスターは GatherWriterStatus を呼び出して、ライターセッションを完了状態に設定する必要があります。

メモこれは、Service Pack 2 (SP2) 以前の Windows Server 2008 でのみ必要です。

CVssWriter クラスは、各ライターによって送信されたステータスメッセージを処理します。

呼び出し元は、 IVssAsync インターフェイスの解放を担当します。

要件

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