Fonction LookupPrivilegeValueA (winbase.h)
La fonction LookupPrivilegeValue récupère l’identificateur local unique (LUID) utilisé sur un système spécifié pour représenter localement le nom de privilège spécifié.
Syntaxe
BOOL LookupPrivilegeValueA(
[in, optional] LPCSTR lpSystemName,
[in] LPCSTR lpName,
[out] PLUID lpLuid
);
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 du privilège sur le système local.
[in] lpName
Pointeur vers une chaîne terminée par null qui spécifie le nom du privilège, tel que défini dans le fichier d’en-tête Winnt.h. Par exemple, ce paramètre peut spécifier la constante, SE_SECURITY_NAME ou sa chaîne correspondante, « SeSecurityPrivilege ».
[out] lpLuid
Pointeur vers une variable qui reçoit le LUID par lequel le privilège est connu sur le système spécifié par le paramètre lpSystemName .
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 LookupPrivilegeValue 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ège.
Exemples
Pour obtenir un exemple qui utilise cette fonction, consultez Activation et désactivation des privilèges.
Notes
L’en-tête winbase.h définit LookupPrivilegeValue en tant qu’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. La combinaison 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 |