MÉTHODE IMDSPDevice2 ::GetCanonicalName (mswmdm.h)

Article
02/29/2024

La méthode GetCanonicalPName obtient le nom canonique d’un appareil.

Syntaxe

HRESULT GetCanonicalName(
  [out] LPWSTR pwszPnPName,
  [in]  UINT   nMaxChars
);

Paramètres

[out] pwszPnPName

Mémoire tampon à caractère large, terminée par null, contenant le nom canonique. L’appelant alloue et libère cette mémoire tampon.

[in] nMaxChars

Entier contenant le nombre maximal de caractères pouvant être placés dans pwszCanonicalName, y compris le caractère d’arrêt.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Remarques

Cette méthode retourne un nom canonique pour l’appareil. Le fournisseur de services doit retourner le nom du chemin d’accès de l’appareil comme nom canonique. Le nom du chemin d’accès de l’appareil est transmis au fournisseur de services dans la méthode CreateDevice sur l’interface IMDServiceProvider2 .

Ce paramètre est facultatif. Pour plus d’informations, consultez Interfaces obligatoires et facultatives.