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

O método QueueGetValuesByObjectList enfileira uma solicitação para uma ou mais propriedades especificadas de um ou mais objetos especificados no dispositivo.

Sintaxe

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

Parâmetros

[in] pObjectIDs

Ponteiro para uma interface IPortableDevicePropVariantCollection que lista as IDs de objeto de todos os objetos a serem consultados. Eles serão do tipo VT_LPWSTR.

[in] pKeys

Ponteiro para uma interface IPortableDeviceKeyCollection que especifica as propriedades a serem solicitadas. Para obter uma lista de propriedades definidas por Dispositivos Portáteis do Windows, consulte Propriedades e Atributos. Especifique NULL para indicar todas as propriedades dos objetos especificados.

[in] pCallback

Ponteiro para uma interface IPortableDevicePropertiesBulkCallback implementada pelo aplicativo que receberá as informações conforme elas forem recuperadas.

[out] pContext

Ponteiro para um GUID usado para iniciar, cancelar ou identificar os retornos de chamada IPortableDevicePropertiesBulkCallback da solicitação, se implementado.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.

Comentários

A solicitação enfileirada não é iniciada até que o aplicativo chame Iniciar. Para obter mais informações sobre como usar esse método, consulte Interface IPortableDevicePropertiesBulk.

Devido a problemas de desempenho, alguns dispositivos podem não retornar uma lista abrangente de propriedades quando o parâmetro pKeys for NULL.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	portabledeviceapi.h
Biblioteca	PortableDeviceGUIDs.lib

Confira também

IPortableDevicePropertiesBulk Interface

IPortableDevicePropertiesBulk::QueueSetValuesByObjectList