GetUserNameExA, fonction (secext.h)
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 |
---|---|
|
La mémoire tampon lpNameBuffer est trop petite. Le paramètre lpnSize contient le nombre d’octets requis pour recevoir le nom. |
|
Le contrôleur de domaine n’est pas disponible pour effectuer la recherche |
|
Le nom d’utilisateur n’est pas disponible dans le format spécifié. |
Notes
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 |