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

La méthode QueueGetValuesByObjectList met en file d’attente une demande pour un ou plusieurs propriétés spécifiées à partir d’un ou plusieurs objets spécifiés sur l’appareil.

Syntaxe

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

Paramètres

[in] pObjectIDs

Pointeur vers une interface IPortableDevicePropVariantCollection qui répertorie les ID d’objet de tous les objets à interroger. Celles-ci seront de type VT_LPWSTR.

[in] pKeys

Pointeur vers une interface IPortableDeviceKeyCollection qui spécifie les propriétés à demander. Pour obtenir la liste des propriétés définies par les appareils portables Windows, consultez Propriétés et attributs. Spécifiez NULL pour indiquer toutes les propriétés des objets spécifiés.

[in] pCallback

Pointeur vers une interface IPortableDevicePropertiesBulkCallback implémentée par l’application qui recevra les informations au fur et à mesure de leur récupération.

[out] pContext

Pointeur vers un GUID utilisé pour démarrer, annuler ou identifier les rappels IPortableDevicePropertiesBulkCallback de demande, s’ils sont implémentés.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK

Remarques

La requête mise en file d’attente n’est pas démarrée tant que l’application n’appelle pas Start. Pour plus d’informations sur l’utilisation de cette méthode, consultez IPortableDevicePropertiesBulk Interface.

En raison de problèmes de performances, certains appareils peuvent ne pas retourner une liste complète de propriétés lorsque le paramètre pKeys a la valeur NULL.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	portabledeviceapi.h
Bibliothèque	PortableDeviceGUIDs.lib

Voir aussi

IPortableDevicePropertiesBulk, interface

IPortableDevicePropertiesBulk ::QueueSetValuesByObjectList