IVssWriterComponents::GetComponent メソッド (vswriter.h)

  • [アーティクル]

GetComponent メソッドは、バックアップ コンポーネント ドキュメントに明示的に格納されている特定のライターのコンポーネントのいずれかに IVssComponent インターフェイスを返します。

構文

HRESULT GetComponent(
  [in]  UINT          iComponent,
  [out] IVssComponent **ppComponent
);

パラメーター

[in] iComponent

コンポーネントの番号。 このパラメーターの値は、0 から n から 1 までの整数です。 ここで、n は IVssWriterComponents::GetComponentCount によって返されるコンポーネントの合計数です。

[out] ppComponent

コンポーネント情報を含む IVssComponent オブジェクトのインスタンスへの二重間接ポインター。

戻り値

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

値 説明
S_OK
 コンポーネントが正常に返されました。
E_INVALIDARG
 パラメーター値の 1 つが無効です。
E_OUTOFMEMORY
 呼び出し元がメモリ不足またはその他のシステム リソースです。
VSS_E_OBJECT_NOT_FOUND
 指定されたコンポーネントが見つかりませんでした。

解説

呼び出し元は、 IUnknown::Release を呼び出して、返された IVssComponent オブジェクトによって保持されているシステム リソースを解放する役割を担います。

要件

   
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー vswriter.h (Vss.h、VsWriter.h を含む)
Library VssApi.lib

関連項目

IVssWriterComponents