Fonction LookupPrivilegeNameA (winbase.h)
La fonction LookupPrivilegeName récupère le nom qui correspond au privilège représenté sur un système spécifique par un identificateur local unique (LUID) spécifié.
Syntaxe
BOOL LookupPrivilegeNameA(
[in, optional] LPCSTR lpSystemName,
[in] PLUID lpLuid,
[out, optional] LPSTR lpName,
[in, out] LPDWORD cchName
);
Paramètres
[in, optional] lpSystemName
Pointeur vers une chaîne terminée par null qui spécifie le nom du système sur lequel le nom de privilège est récupéré. Si une chaîne null est spécifiée, la fonction tente de trouver le nom de privilège sur le système local.
[in] lpLuid
Pointeur vers le LUID par lequel le privilège est connu sur le système cible.
[out, optional] lpName
Pointeur vers une mémoire tampon qui reçoit une chaîne terminée par null qui représente le nom de privilège. Par exemple, cette chaîne peut être « SeSecurityPrivilege ».
[in, out] cchName
Pointeur vers une variable qui spécifie la taille, dans une valeur TCHAR , de la mémoire tampon lpName . Lorsque la fonction retourne, ce paramètre contient la longueur du nom de privilège, sans inclure le caractère null de fin. Si la mémoire tampon pointée vers le paramètre lpName est trop petite, cette variable contient la taille requise.
Valeur retournée
Si la fonction réussit, la fonction retourne une valeur différente de zéro.
Si la fonction échoue, elle retourne zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
La fonction LookupPrivilegeName prend uniquement en charge les privilèges spécifiés dans la section Privilèges définis de Winnt.h. Pour obtenir la liste des valeurs, consultez Constantes de privilèges.
Notes
L’en-tête winbase.h définit LookupPrivilegeName 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.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP [applications de bureau | applications UWP] |
| Serveur minimal pris en charge | Windows Server 2003 [applications de bureau | applications UWP] |
| Plateforme cible | Windows |
| En-tête | winbase.h (inclure Windows.h) |
| Bibliothèque | Advapi32.lib |
| DLL | Advapi32.dll |