MÉTHODE IMDSPDevice ::GetName (mswmdm.h)

Article
03/04/2024

La méthode GetName récupère le nom de l’appareil.

Syntaxe

HRESULT GetName(
  [out] LPWSTR pwszName,
  [in]  UINT   nMaxChars
);

Paramètres

[out] pwszName

Pointeur vers un tableau de caractères Unicode 16 bits qui reçoit la chaîne de nom d’appareil.

[in] nMaxChars

Nombre maximal de caractères à copier dans la chaîne.

Valeur retournée

Cette méthode retourne un code HRESULT. Toutes les méthodes d’interface dans Windows Media Gestionnaire de périphériques peuvent retourner l’une des classes suivantes de codes d’erreur :

Codes d’erreur COM standard
Codes d’erreur Windows convertis en valeurs HRESULT
Codes d’erreur Gestionnaire de périphériques Windows Media

Pour obtenir une liste complète des codes d’erreur possibles, consultez Codes d’erreur.

Remarques

Le type de chaîne LPWSTR est une chaîne de caractères Unicode 16 bits et n’accepte pas les caractères de taille octet. Pour convertir une chaîne de caractères de taille octet (LPCSTR) en chaîne LPWSTR , utilisez la fonction MultiByteToWideChar comme décrit dans la documentation Microsoft Windows.

Les noms d’appareils ne doivent pas contenir d’espaces de fin.

Cette méthode doit être implémentée. Il ne doit pas retourner WMDM_E_NOTSUPPORTED ni E_NOTIMPL. Pour plus d’informations, consultez Interfaces obligatoires et facultatives.

Configuration requise

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

Voir aussi

IMDSPDevice, interface

IMDSPDevice ::GetType

Partager via