Partager via


Fonction DsGetFriendlyClassName (dsclient.h)

La fonction DsGetFriendlyClassName récupère le nom localisé d’une classe d’objet. Cette fonction est obsolète. Les nouvelles applications doivent utiliser la méthode IDsDisplaySpecifier ::GetFriendlyClassName pour effectuer cette fonction.

Syntaxe

HRESULT DsGetFriendlyClassName(
  [in] LPCWSTR pszObjectClass,
  [in] LPWSTR  pszBuffer,
  [in] UINT    cchBuffer
);

Paramètres

[in] pszObjectClass

Pointeur vers une chaîne Unicode terminée par un caractère Null qui contient le nom de la classe d’objet à obtenir. Les exemples de nom de la classe d’objet sont « user » et « container ».

[in] pszBuffer

Pointeur vers une mémoire tampon de caractères large qui reçoit la chaîne de nom. Cette mémoire tampon doit comporter au moins des caractères larges cchBuffer .

[in] cchBuffer

Contient la taille de la mémoire tampon pszBuffer , en caractères larges, y compris le caractère NULL de fin. Si le nom dépasse ce nombre de caractères, le nom est tronqué.

Valeur retournée

Retourne une valeur HRESULT standard, y compris les éléments suivants.

Remarques

Si aucun nom convivial n’est défini dans les spécificateurs d’affichage pour la classe d’objet, cette fonction retourne le nom passé dans pszObjectClass.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Vista
Serveur minimal pris en charge Windows Server 2008
Plateforme cible Windows
En-tête dsclient.h
Bibliothèque Dsuiext.lib
DLL Dsuiext.dll

Voir aussi

IDsDisplaySpecifier ::GetFriendlyClassName