IPortableDeviceValuesCollection::GetAt メソッド

GetAt メソッドは、0 から始まるインデックスによってコレクションから項目を取得します。

構文

HRESULT GetAt(
  [in]  const DWORD                 dwIndex,
  [out]       IPortableDeviceValues **ppValues
);

dwIndex [in]: コレクション内の 0 から始まるインデックスを指定する DWORD。
ppValues [out]: コレクションから IPortableDeviceValues インターフェイスへのポインターを受け取る変数のアドレス。呼び出し元は、このインターフェイスで完了したときに Release を呼び出す役割を担います。

このメソッドは HRESULT を返します。有効な値を次の表に示しますが、これ以外にもあります。

リターンコード	説明
S_OK	メソッドが成功しました。
E_INVALIDARG	渡された 0 から始まるインデックスが範囲外でした。
E_POINTER	必要なポインター引数が NULL でした。
E_UNEXPECTED	コレクションには NULLIPortableDeviceValues ポインターが含まれています。

取得したインターフェイスの値に加えられた変更は、コレクションに格納されているバージョンに対して行われます。

要件	値
ヘッダー	PortableDeviceTypes.h
ライブラリ	PortableDeviceGUIDs.lib