Méthode IPart ::GetName (devicetopology.h)

La méthode GetName obtient le nom convivial de cette partie.

Syntaxe

HRESULT GetName(
  [out] LPWSTR *ppwstrName
);

Paramètres

[out] ppwstrName

Pointeur vers une variable de pointeur dans laquelle la méthode écrit l’adresse d’une chaîne à caractères larges terminée par null qui contient le nom convivial de cette partie. La méthode alloue le stockage pour la chaîne. L’appelant est chargé de libérer le stockage, lorsqu’il n’est plus nécessaire, en appelant la fonction CoTaskMemFree . Si l’appel GetName échoue, *ppwstrName a la valeur NULL. Pour plus d’informations sur CoTaskMemFree, consultez la documentation du Kit de développement logiciel (SDK) Windows.

Valeur retournée

Si la méthode réussit, retourne S_OK. En cas d’échec, les codes de retour possibles incluent, sans s’y limiter, les valeurs indiquées dans le tableau suivant.

Code de retour	Description
E_POINTER	Le pointeur ppwstrName a la valeur NULL.

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	devicetopology.h

Voir aussi

IPart, interface