GetUserNameExA, fonction (secext.h)

Article
11/20/2024

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 au format spécifié. La mémoire tampon doit inclure de l’espace pour le caractère null de fin.

[in, out] nSize

Lors de l’entrée, cette variable spécifie la taille de la mémoire tampon lpNameBuffer, dans TCHARs . Si la fonction réussit, la variable reçoit le nombre d'TCHAR copiées 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 (si Unicode est utilisé ou non), y compris le caractère Null de fin.

Valeur de retour

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’erreur étendues, appelez GetLastError. Les valeurs possibles sont les suivantes.

Retourner le code	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é.

Remarques

Note

L’en-tête secext.h définit GetUserNameEx comme 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’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

Partager via