Compartir a través de

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

  • Artículo

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