IPortableDevicePropertiesBulk::QueueGetValuesByObjectList 方法 (portabledeviceapi.h)
QueueGetValuesByObjectList 方法會將裝置上一或多個指定物件的要求排入佇列。
語法
HRESULT QueueGetValuesByObjectList(
[in] IPortableDevicePropVariantCollection *pObjectIDs,
[in] IPortableDeviceKeyCollection *pKeys,
[in] IPortableDevicePropertiesBulkCallback *pCallback,
[out] GUID *pContext
);
參數
[in] pObjectIDs
IPortableDevicePropVariantCollection 介面的指標,此介面會列出要查詢之所有對象的物件標識符。 這些類型為 VT_LPWSTR。
[in] pKeys
指定要要求之屬性的 IPortableDeviceKeyCollection 介面指標。 如需 Windows 可攜式裝置所定義的屬性清單,請參閱 屬性和屬性。 指定 NULL 以指出來自指定物件的所有屬性。
[in] pCallback
應用程式實作 IPortableDevicePropertiesBulkCallback 介面的指標,它會在擷取資訊時接收資訊。
[out] pContext
用來啟動、取消或識別要求 IPortableDevicePropertiesBulkCallback 回 呼的 GUID 指標,如果實作的話。
傳回值
方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。
傳回碼 | 描述 |
---|---|
|
此方法已成功。 |
備註
在應用程式呼叫 Start 之前,不會啟動佇列要求。 如需如何使用此方法的詳細資訊,請參閱 IPortableDevicePropertiesBulk 介面。
由於效能問題,某些裝置在 pKeys 參數為 NULL 時可能不會傳回完整的屬性清單。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | portabledeviceapi.h |
程式庫 | PortableDeviceGUIDs.lib |