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