IVssExamineWriterMetadata::GetComponent メソッド (vsbackup.h)
GetComponent メソッドは、指定されたバックアップ コンポーネントのライター メタデータ ドキュメントを取得します。
構文
HRESULT GetComponent(
[in] UINT iComponent,
[out] IVssWMComponent **ppComponent
);
パラメーター
[in] iComponent
コンポーネントのインデックス。 このパラメーターの値は、0 から n から 1 までの整数です。 n は、特定のライターでサポートされるコンポーネントの合計数です。 n の値は、IVssExamineWriterMetadata::GetFileCounts によって返されます。
[out] ppComponent
コンポーネント情報を含む IVssWMComponent オブジェクトへの二重間接ポインター。
戻り値
このメソッドの有効なリターン コードを次に示します。
| 値 | 意味 |
|---|---|
|
IVssWMComponent インターフェイスへのポインターが正常に返されました。 |
|
パラメーター値の 1 つが無効です。 |
|
呼び出し元がメモリ不足またはその他のシステム リソースです。 |
|
XML ドキュメントが無効です。 詳細については、イベント ログを確認してください。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。 |
|
指定されたコンポーネントが存在しません。 |
|
予期しないエラー。 エラー コードはエラー ログ ファイルに記録されます。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。
Windows Server 2008、Windows Vista、Windows Server 2003、Windows XP: この値は、Windows Server 2008 R2 および Windows 7 まではサポートされません。 代わりに、E_UNEXPECTEDが使用されます。 |
注釈
呼び出し元は、 IUnknown::Release を呼び出して、返された IVssWMComponent オブジェクトのリソースを解放する必要があります。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
| サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
| 対象プラットフォーム | Windows |
| ヘッダー | vsbackup.h (VsBackup.h、Vss.h、VsWriter.h を含む) |
| Library | VssApi.lib |