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

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

こちらもご覧ください

CVssWriter

IVssAsync

IVssAsync::QueryStatus

IVssBackupComponents

IVssBackupComponents::FreeWriterStatus