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 オブジェクトへの二重間接ポインター。

戻り値

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

意味
S_OK
IVssWMComponent インターフェイスへのポインターが正常に返されました。
E_INVALIDARG
パラメーター値の 1 つが無効です。
E_OUTOFMEMORY
呼び出し元がメモリ不足またはその他のシステム リソースです。
VSS_E_INVALID_XML_DOCUMENT
XML ドキュメントが無効です。 詳細については、イベント ログを確認してください。 詳細については、「 VSS でのイベントとエラーの処理」を参照してください。
VSS_E_OBJECT_NOT_FOUND
指定されたコンポーネントが存在しません。
VSS_E_UNEXPECTED
予期しないエラー。 エラー コードはエラー ログ ファイルに記録されます。 詳細については、「 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

こちらもご覧ください

IVssExamineWriterMetadata

IVssExamineWriterMetadata::GetFileCounts

IVssWMComponent