Partager via


Méthode IPortableDeviceManager ::GetDeviceProperty (portabledeviceapi.h)

Récupère une valeur de propriété stockée par l’appareil sur l’ordinateur. (Il ne s’agit pas de propriétés standard définies par les appareils portables Windows.)

Syntaxe

HRESULT GetDeviceProperty(
  [in]      LPCWSTR pszPnPDeviceID,
  [in]      LPCWSTR pszDevicePropertyName,
  [in, out] BYTE    *pData,
  [in, out] DWORD   *pcbData,
  [in, out] DWORD   *pdwType
);

Paramètres

[in] pszPnPDeviceID

Pointeur vers une chaîne terminée par null qui contient l’ID de Plug-and-Play de l’appareil. Vous pouvez récupérer une liste de noms de Plug-and-Play de tous les appareils connectés à l’ordinateur en appelant GetDevices.

[in] pszDevicePropertyName

Pointeur vers une chaîne terminée par null qui contient le nom de la propriété à demander. Il s’agit de noms de propriétés personnalisées définis par un fabricant d’appareil.

[in, out] pData

Mémoire tampon allouée à l’appelant pour contenir les données récupérées. Pour obtenir la taille requise, appelez cette méthode avec ce paramètre défini sur NULL et pcbData défini sur zéro, et la taille requise sera récupérée dans pcbData. Cet appel retourne également une erreur qui peut être ignorée. Consultez Valeurs de retour.

[in, out] pcbData

Taille de la mémoire tampon allouée ou retournée par pData, en octets.

[in, out] pdwType

Constante décrivant le type de données retournées dans pData. Les valeurs de ce paramètre sont les mêmes que celles utilisées pour décrire le paramètre lpType de la fonction du KIT de développement logiciel (SDK) de plateforme RegQueryValueEx.

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
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)
La mémoire tampon fournie n’est pas assez grande pour contenir les données demandées. (Ce résultat est toujours retourné lorsque pData a la valeur NULL. Vous pouvez ignorer ce résultat si vous appelez la méthode pour récupérer la taille de mémoire tampon requise. Consultez la description du paramètre pData .)
E_POINTER
Au moins l’un des arguments requis était un pointeur NULL .

Remarques

Ces valeurs de propriété sont stockées lors de l’installation de l’appareil ou stockées par un appareil pendant l’opération afin qu’elles puissent être conservées entre les sessions de connexion. Une application doit connaître le nom exact de la propriété, qui est spécifié par l’appareil lui-même ; Par conséquent, cette méthode est destinée à être utilisée par les développeurs d’appareils qui créent leurs propres applications.

Pour obtenir les propriétés des appareils portables Windows à partir de l’objet d’appareil, appelez IPortableDeviceProperties ::GetValues et spécifiez l’objet appareil avec WPD_DEVICE_OBJECT_ID.

Configuration requise

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

Voir aussi

IPortableDeviceManager, interface

IPortableDeviceManager ::GetDevices