GetUserNameExA, fonction (secext.h)

Article
08/25/2023

Récupère le nom de l’utilisateur ou d’un autre principal de sécurité associé au thread appelant. Vous pouvez spécifier le format du nom retourné.

Si le thread emprunte l’identité d’un client, GetUserNameEx retourne le nom du client.

Syntaxe

BOOLEAN SEC_ENTRY GetUserNameExA(
  [in]      EXTENDED_NAME_FORMAT NameFormat,
  [out]     LPSTR                lpNameBuffer,
  [in, out] PULONG               nSize
);

Paramètres

[in] NameFormat

Format du nom. Ce paramètre est une valeur du type d’énumération EXTENDED_NAME_FORMAT . Il ne peut pas être NameUnknown. Si le compte d’utilisateur n’est pas dans un domaine, seul NameSamCompatible est pris en charge.

[out] lpNameBuffer

Pointeur vers une mémoire tampon qui reçoit le nom dans le format spécifié. La mémoire tampon doit inclure de l’espace pour le caractère null de fin.

[in, out] nSize

En entrée, cette variable spécifie la taille de la mémoire tampon lpNameBuffer , dans les TCHAR. Si la fonction réussit, la variable reçoit le nombre de TCHAR copiés dans la mémoire tampon, sans inclure le caractère null de fin.

Si lpNameBuffer est trop petit, la fonction échoue et GetLastError retourne ERROR_MORE_DATA. Ce paramètre reçoit la taille de mémoire tampon requise, en caractères Unicode (qu’Unicode soit utilisé ou non), y compris le caractère null de fin.

Valeur retournée

Si la fonction réussit, la valeur de retour est une valeur différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError. Les valeurs possibles sont les suivantes.

Code de retour	Description
ERROR_MORE_DATA	La mémoire tampon lpNameBuffer est trop petite. Le paramètre lpnSize contient le nombre d’octets requis pour recevoir le nom.
ERROR_NO_SUCH_DOMAIN	Le contrôleur de domaine n’est pas disponible pour effectuer la recherche
ERROR_NONE_MAPPED	Le nom d’utilisateur n’est pas disponible dans le format spécifié.

Notes

L’en-tête secext.h définit GetUserNameEx comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Spécifications


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	secext.h (include Security.h)
Bibliothèque	Secur32.lib
DLL	Secur32.dll

Voir aussi

EXTENDED_NAME_FORMAT

LookupAccountName

Fonctions d’information système