IPortableDevicePropertiesBulk::QueueGetValuesByObjectList 메서드(portabledeviceapi.h)
QueueGetValuesByObjectList 메서드는 디바이스에 있는 하나 이상의 지정된 개체에서 하나 이상의 지정된 속성에 대한 요청을 큐에 대기합니다.
구문
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를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.
| 반환 코드 | Description |
|---|---|
|
메서드가 성공했습니다. |
설명
큐에 대기 중인 요청은 애플리케이션이 Start를 호출할 때까지 시작되지 않습니다. 이 메서드를 사용하는 방법에 대한 자세한 내용은 IPortableDevicePropertiesBulk 인터페이스를 참조하세요.
성능 문제로 인해 pKeys 매개 변수가 NULL인 경우 일부 디바이스는 포괄적인 속성 목록을 반환하지 않을 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | Windows |
| 헤더 | portabledeviceapi.h |
| 라이브러리 | PortableDeviceGUIDs.lib |