Méthode IPropertyDescription ::GetCanonicalName (propsys.h)

  • Article

Obtient le nom respectant la casse par lequel une propriété est connue du système, quel que soit son nom localisé.

Syntaxe

HRESULT GetCanonicalName(
  [out] LPWSTR *ppszName
);

Paramètres

[out] ppszName

Type : LPWSTR*

Lorsque cette méthode retourne, contient l’adresse d’un pointeur vers le nom canonique de la propriété en tant que chaîne Unicode terminée par null.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Les informations récupérées par cette méthode proviennent de l’attribut name de l’élément propertyDescription dans le fichier .propdesc de la propriété.

Il incombe à l’application appelante d’utiliser CoTaskMemFree pour libérer la chaîne référencée par ppszName lorsqu’elle n’est plus nécessaire.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
Plateforme cible Windows
En-tête propsys.h

Voir aussi

IPropertyDescription

Schéma de description de propriété