Fonction LookupPrivilegeDisplayNameW (winbase.h)
La fonction LookupPrivilegeDisplayName récupère le nom d’affichage qui représente un privilège spécifié.
Syntaxe
BOOL LookupPrivilegeDisplayNameW(
[in, optional] LPCWSTR lpSystemName,
[in] LPCWSTR lpName,
[out, optional] LPWSTR lpDisplayName,
[in, out] LPDWORD cchDisplayName,
[out] LPDWORD lpLanguageId
);
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 d’affichage 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 Winnt.h. Par exemple, ce paramètre peut spécifier la constante, SE_REMOTE_SHUTDOWN_NAME ou sa chaîne correspondante, « SeRemoteShutdownPrivilege ». Pour obtenir la liste des valeurs, consultez Constantes de privilèges.
[out, optional] lpDisplayName
Pointeur vers une mémoire tampon qui reçoit une chaîne terminée par null qui spécifie le nom d’affichage du privilège. Par exemple, si le paramètre lpName est SE_REMOTE_SHUTDOWN_NAME, le nom d’affichage du privilège est « Forcer l’arrêt à partir d’un système distant ».
[in, out] cchDisplayName
Pointeur vers une variable qui spécifie la taille, en TCHARs, de la mémoire tampon lpDisplayName . Lorsque la fonction retourne, ce paramètre contient la longueur du nom d’affichage du privilège, sans inclure le caractère null de fin. Si la mémoire tampon pointée vers le paramètre lpDisplayName est trop petite, cette variable contient la taille requise.
[out] lpLanguageId
Pointeur vers une variable qui reçoit l’identificateur de langue du nom d’affichage retourné.
Valeur retournée
Si la fonction réussit, la valeur de retour est 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.
Remarques
La fonction LookupPrivilegeDisplayName récupère les noms d’affichage uniquement pour les privilèges spécifiés dans la section Privilèges définis de Winnt.h.
Notes
L’en-tête winbase.h définit LookupPrivilegeDisplayName 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 |
Voir aussi
Vue d’ensemble du contrôle d’accès
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour