IPortableDevicePropertiesBulk::QueueGetValuesByObjectList メソッド (portabledeviceapi.h)
QueueGetValuesByObjectList メソッドは、デバイス上の 1 つ以上の指定されたオブジェクトから 1 つ以上の指定されたプロパティの要求をキューに入れます。
構文
HRESULT QueueGetValuesByObjectList(
[in] IPortableDevicePropVariantCollection *pObjectIDs,
[in] IPortableDeviceKeyCollection *pKeys,
[in] IPortableDevicePropertiesBulkCallback *pCallback,
[out] GUID *pContext
);
パラメーター
[in] pObjectIDs
クエリを実行するすべてのオブジェクトのオブジェクト ID を一覧表示する IPortableDevicePropVariantCollection インターフェイスへのポインター。 これらは VT_LPWSTR 型になります。
[in] pKeys
要求するプロパティを指定する IPortableDeviceKeyCollection インターフェイスへのポインター。 Windows ポータブル デバイスで定義されているプロパティの一覧については、「 プロパティと属性」を参照してください。 指定したオブジェクトのすべてのプロパティを示すには 、NULL を 指定します。
[in] pCallback
取得時に情報を受け取る、アプリケーションによって実装された IPortableDevicePropertiesBulkCallback インターフェイスへのポインター。
[out] pContext
実装されている場合は、 要求 IPortableDevicePropertiesBulkCallback コールバックを開始、取り消し、または識別するために使用される GUID へのポインター。
戻り値
このメソッドは HRESULT を返します。 有効な値を次の表に示しますが、これ以外にもあります。
| リターン コード | 説明 |
|---|---|
|
メソッドが成功しました。 |
注釈
キューに入った要求は、アプリケーションが Start を呼び出すまで 開始されません。 このメソッドの使用方法の詳細については、「 IPortableDevicePropertiesBulk インターフェイス」を参照してください。
パフォーマンスの問題により、 pKeys パラメーターが NULL の場合、一部のデバイスはプロパティの包括的な一覧を返さない場合があります。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | Windows |
| ヘッダー | portabledeviceapi.h |
| Library | PortableDeviceGUIDs.lib |