IPortableDeviceProperties ::GetValues, méthode (portabledeviceapi.h)

Article
03/04/2024

La méthode GetValues récupère une liste de propriétés spécifiées à partir d’un objet spécifié sur un appareil.

Syntaxe

HRESULT GetValues(
  [in]  LPCWSTR                      pszObjectID,
  [in]  IPortableDeviceKeyCollection *pKeys,
  [out] IPortableDeviceValues        **ppValues
);

Paramètres

[in] pszObjectID

Pointeur vers une chaîne terminée par null qui contient l’ID de l’objet à interroger. Pour spécifier l’appareil, utilisez WPD_DEVICE_OBJECT_ID.

[in] pKeys

Pointeur vers une interface IPortableDeviceKeyCollection qui contient une ou plusieurs propriétés à rechercher. Si cette valeur est NULL, toutes les propriétés seront récupérées. Pour obtenir la liste des propriétés définies par les appareils portables Windows, consultez Propriétés et attributs .

[out] ppValues

Adresse d’une variable qui reçoit un pointeur vers une interface IPortableDeviceValues qui contient les valeurs de propriété demandées. Celles-ci sont retournées sous forme de paires PROPERTYKEY/value, où le type de données de la valeur dépend de la propriété. Si une valeur n’a pas pu être récupérée pour une raison quelconque, le type retourné est VT_ERROR et contient une valeur HRESULT décrivant l’erreur de récupération. L’appelant doit libérer cette interface lorsqu’il l’a terminé.

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	Toutes les valeurs de propriété demandées ont été récupérées.
S_FALSE	Une ou plusieurs valeurs de propriété n’ont pas pu être récupérées. Les propriétés problématiques auront une valeur HRESULT dans le paramètre ppValues récupéré.