IPortableDeviceManager ::GetDeviceManufacturer, méthode (portabledeviceapi.h)

Article
03/04/2024

Récupère le nom du fabricant de l’appareil.

Syntaxe

HRESULT GetDeviceManufacturer(
  [in]      LPCWSTR pszPnPDeviceID,
  [in, out] WCHAR   *pDeviceManufacturer,
  [in, out] DWORD   *pcchDeviceManufacturer
);

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, out] pDeviceManufacturer

Mémoire tampon allouée à l’appelant qui contient le nom du fabricant de l’appareil. Pour connaître la taille requise pour ce paramètre, appelez d’abord cette méthode avec ce paramètre défini sur NULL et pcchDeviceManufacturer défini sur 0 ; la méthode réussit et définit pcchDeviceManufacturer sur la taille de mémoire tampon requise pour contenir le nom convivial de l’appareil, y compris le caractère d’arrêt.

[in, out] pcchDeviceManufacturer

En entrée, le nombre maximal de caractères que pDeviceManufacturer peut contenir , sans compter le caractère de fin. En sortie, le nombre de caractères retournés par pDeviceManufacturer, sans compter le caractère de fin.

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
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	La mémoire tampon fournie n’est pas assez grande pour contenir la description de l’appareil. (Reportez-vous à la valeur retournée dans pcchDeviceDescription pour connaître la taille requise.)
HRESULT_FROM_WIN32(ERROR_INVALID_DATA)	La description de l’appareil est introuvable.
S_OK	S_OK
E_POINTER	Au moins un des arguments requis était un pointeur NULL .

Configuration requise

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

Voir aussi

IPortableDeviceManager, interface

IPortableDeviceManager ::GetDevices

Partager via