Metodo IPortableDevicePropertiesBulk::QueueGetValuesByObjectList (portabledeviceapi.h)

Il metodo QueueGetValuesByObjectList accoda una richiesta per una o più proprietà specificate da uno o più oggetti specificati nel dispositivo.

Sintassi

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

Parametri

[in] pObjectIDs

Puntatore a un'interfaccia IPortableDevicePropVariantCollection che elenca gli ID oggetto di tutti gli oggetti da eseguire in query. Questi saranno di tipo VT_LPWSTR.

[in] pKeys

Puntatore a un'interfaccia IPortableDeviceKeyCollection che specifica le proprietà da richiedere. Per un elenco di proprietà definite dai dispositivi portatili Windows, vedere Proprietà e attributi. Specificare NULL per indicare tutte le proprietà degli oggetti specificati.

[in] pCallback

Puntatore a un'interfaccia IPortableDevicePropertiesBulkCallback implementata dall'applicazione che riceverà le informazioni recuperate.

[out] pContext

Puntatore a un GUID usato per avviare, annullare o identificare la richiesta IPortableDevicePropertiesBulkCallback , se implementata.

Valore restituito

Il metodo restituisce un HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice restituito	Descrizione
S_OK	Il metodo è riuscito.

Commenti

La richiesta in coda non viene avviata fino a quando l'applicazione chiama Start. Per altre informazioni su come usare questo metodo, vedere Interfaccia IPortableDevicePropertiesBulk.

A causa di problemi di prestazioni, alcuni dispositivi potrebbero non restituire un elenco completo di proprietà quando il parametro pKeys è NULL.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	portabledeviceapi.h
Libreria	PortableDeviceGUIDs.lib

Vedi anche

Interfaccia IPortableDevicePropertiesBulk

IPortableDevicePropertiesBulk::QueueSetValuesByObjectList