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 |
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 |