IPortableDeviceProperties::GetValues メソッド (portabledeviceapi.h)

[アーティクル]
03/13/2024

GetValues メソッドは、デバイス上の指定したオブジェクトから、指定したプロパティの一覧を取得します。

構文

HRESULT GetValues(
  [in]  LPCWSTR                      pszObjectID,
  [in]  IPortableDeviceKeyCollection *pKeys,
  [out] IPortableDeviceValues        **ppValues
);

パラメーター

[in] pszObjectID

クエリを実行するオブジェクトの ID を含む null で終わる文字列へのポインター。デバイスを指定するには、WPD_DEVICE_OBJECT_IDを使用します。

[in] pKeys

クエリを実行する 1 つ以上のプロパティを含む IPortableDeviceKeyCollection インターフェイスへのポインター。これが NULL の場合、すべてのプロパティが取得されます。 Windows ポータブルデバイスで定義されているプロパティの一覧については、「プロパティと属性」を参照してください。

[out] ppValues

要求されたプロパティ値を含む IPortableDeviceValues インターフェイスへのポインターを受け取る変数のアドレス。これらは PROPERTYKEY/値ペアとして返されます。ここで、値のデータ型はプロパティによって異なります。何らかの理由で値を取得できなかった場合、返される型はVT_ERRORされ、取得エラーを説明する HRESULT 値が含まれます。呼び出し元は、このインターフェイスが完了したら、このインターフェイスを解放する必要があります。

戻り値

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

リターンコード	説明
S_OK	要求されたすべてのプロパティ値が取得されました。
S_FALSE	1 つ以上のプロパティ値を取得できませんでした。問題のプロパティは、取得した ppValues パラメーターに HRESULT 値を持ちます。