GatherWriterStatus メソッドは、各ライターにステータス メッセージの送信を求めます。
構文
HRESULT GatherWriterStatus(
[out] IVssAsync **pAsync
);
パラメーター
[out] pAsync
ライターの状態データを含む IVssAsync オブジェクトへの二重間接ポインター。
戻り値
このメソッドの有効なリターン コードを次に示します。
| 値 | 意味 |
|---|---|
|
IVssAsync インターフェイスのインスタンスへのポインターが正常に返されました。 pHrResult パラメーターによって返される有効な値については、「IVssAsync::QueryStatus」を参照してください。 |
|
呼び出し元が十分なバックアップ特権を持っていないか、管理者ではありません。 |
|
ppAsync は有効なポインターを指していません。つまり、 NULL です。 |
|
呼び出し元がメモリやその他のシステム リソースを使い切れている。 |
|
バックアップ コンポーネント オブジェクトが初期化されていないか、復元操作中にこのメソッドが呼び出されたか、このメソッドが正しいシーケンス内で呼び出されていません。 |
|
予期しないエラー。 エラー コードは、エラー ログ ファイルに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。
Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 と Windows 7 まではサポートされません。 代わりに E_UNEXPECTED が使用されます。 |
|
ライター インフラストラクチャが正しく動作していません。 イベント サービスと VSS が開始されていることを確認し、それらのサービスに関連するエラーをエラー ログにチェックします。 |
注釈
このメソッドの呼び出し元は、各ライターの状態を受信した後、 IVssBackupComponents::FreeWriterStatus も呼び出す必要があります。
BackupComplete を呼び出した後、リクエスターは GatherWriterStatus を呼び出して、ライター セッションを完了状態に設定する必要があります。
メモ これは、Service Pack 2 (SP2) 以前の Windows Server 2008 でのみ必要です。
呼び出し元は、 IVssAsync インターフェイスの解放を担当します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | vsbackup.h (VsBackup.h、Vss.h、VsWriter.h を含む) |
| Library | VssApi.lib |