Méthode IWMDeviceManager2 ::GetDeviceFromCanonicalName (mswmdm.h)

Article
02/29/2024

La méthode GetDeviceFromCanonicalName récupère une interface IWMDMDevice pour un appareil avec un nom canonique spécifié. Vous pouvez récupérer le nom canonique d’un appareil en appelant IWMDMDevice2 ::GetCanonicalName.

Syntaxe

HRESULT GetDeviceFromCanonicalName(
  LPCWSTR     pwszCanonicalName,
  IWMDMDevice **ppDevice
);

Paramètres

pwszCanonicalName

Chaîne à caractères larges et terminée par null spécifiant le nom canonique de l’appareil.

ppDevice

Pointeur vers un pointeur vers l’interface IWMDMDevice de l’objet d’appareil avec le nom canonique spécifié. 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
E_INVALIDARG	Le paramètre pwszCanonicalName ou ppDeviceArray est un pointeur non valide ou NULL .
S_FALSE	Aucun appareil connecté n’est trouvé avec le nom canonique pwszCanonicalName.

Remarques

Cette méthode peut être utile si une application implémente IWMDMNotification, qui envoie une notification de nom canonique lorsqu’un appareil se connecte ou se déconnecte de l’ordinateur.

Configuration requise

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

Voir aussi

IWMDMDevice2 Interface

IWMDeviceManager2 Interface

Partager via