Método IPortableDevicePropertiesBulk::QueueGetValuesByObjectList (portabledeviceapi.h)

El método QueueGetValuesByObjectList pone en cola una solicitud de una o varias propiedades especificadas de uno o varios objetos especificados en el dispositivo.

Sintaxis

HRESULT QueueGetValuesByObjectList(
  [in]  IPortableDevicePropVariantCollection  *pObjectIDs,
  [in]  IPortableDeviceKeyCollection          *pKeys,
  [in]  IPortableDevicePropertiesBulkCallback *pCallback,
  [out] GUID                                  *pContext
);

Parámetros

[in] pObjectIDs

Puntero a una interfaz IPortableDevicePropVariantCollection que enumera los identificadores de objeto de todos los objetos que se van a consultar. Estos serán de tipo VT_LPWSTR.

[in] pKeys

Puntero a una interfaz IPortableDeviceKeyCollection que especifica las propiedades que se van a solicitar. Para obtener una lista de las propiedades definidas por dispositivos portátiles de Windows, vea Propiedades y atributos. Especifique NULL para indicar todas las propiedades de los objetos especificados.

[in] pCallback

Puntero a una interfaz IPortableDevicePropertiesBulkCallback implementada por la aplicación que recibirá la información a medida que se recupera.

[out] pContext

Puntero a un GUID que se usa para iniciar, cancelar o identificar las devoluciones de llamada IPortableDevicePropertiesBulkCallback de solicitud, si se implementa.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.

Comentarios

La solicitud en cola no se inicia hasta que la aplicación llama a Start. Para obtener más información sobre cómo usar este método, vea IPortableDevicePropertiesBulk Interface.

Debido a problemas de rendimiento, es posible que algunos dispositivos no devuelvan una lista completa de propiedades cuando el parámetro pKeys es NULL.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	portabledeviceapi.h
Library	PortableDeviceGUIDs.lib

Consulte también

IPortableDevicePropertiesBulk (Interfaz)

IPortableDevicePropertiesBulk::QueueSetValuesByObjectList