Fonction LookupPrivilegeDisplayNameA (winbase.h)

Article
11/20/2024

La fonction LookupPrivilegeDisplayName récupère le nom complet qui représente un privilège spécifié.

Syntaxe

BOOL LookupPrivilegeDisplayNameA(
  [in, optional]  LPCSTR  lpSystemName,
  [in]            LPCSTR  lpName,
  [out, optional] LPSTR   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 complet 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 privilege.

[out, optional] lpDisplayName

Pointeur vers une mémoire tampon qui reçoit une chaîne terminée par null qui spécifie le nom complet du privilège. Par exemple, si le paramètre lpName est SE_REMOTE_SHUTDOWN_NAME, le nom complet 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, dans TCHAR, de la mémoire tampon lpDisplayName . Lorsque la fonction est retournée, ce paramètre contient la longueur du nom d’affichage des privilèges, sans inclure le caractère null de fin. Si la mémoire tampon pointée par 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 complet retourné.

Valeur de retour

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’erreur étendues, 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.

Note

L’en-tête winbase.h définit LookupPrivilegeDisplayName 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 XP [applications de bureau \| Applications UWP]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau \| Applications UWP]
plateforme cible	Windows
d’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

fonctions de contrôle d’accès de base

LookupPrivilegeName

LookupPrivilegeValue

Partager via