Partager via

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

  • Article

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