Funzione LookupPrivilegeDisplayNameA (winbase.h)
La funzione LookupPrivilegeDisplayName recupera il nome visualizzato che rappresenta un privilegio specificato.
Sintassi
BOOL LookupPrivilegeDisplayNameA(
[in, optional] LPCSTR lpSystemName,
[in] LPCSTR lpName,
[out, optional] LPSTR lpDisplayName,
[in, out] LPDWORD cchDisplayName,
[out] LPDWORD lpLanguageId
);
Parametri
[in, optional] lpSystemName
Puntatore a una stringa con terminazione null che specifica il nome del sistema in cui viene recuperato il nome del privilegio. Se viene specificata una stringa Null, la funzione tenta di trovare il nome visualizzato nel sistema locale.
[in] lpName
Puntatore a una stringa con terminazione null che specifica il nome del privilegio, come definito in Winnt.h. Ad esempio, questo parametro potrebbe specificare la costante, SE_REMOTE_SHUTDOWN_NAME o la relativa stringa corrispondente, "SeRemoteShutdownPrivilege". Per un elenco di valori, vedere Costanti dei privilegi.
[out, optional] lpDisplayName
Puntatore a un buffer che riceve una stringa con terminazione null che specifica il nome visualizzato dei privilegi. Ad esempio, se il parametro lpName è SE_REMOTE_SHUTDOWN_NAME, il nome visualizzato dei privilegi è "Forza l'arresto da un sistema remoto".
[in, out] cchDisplayName
Puntatore a una variabile che specifica le dimensioni, in TCHARs, del buffer lpDisplayName . Quando la funzione restituisce, questo parametro contiene la lunghezza del nome visualizzato dei privilegi, non incluso il carattere null terminante. Se il buffer puntato al parametro lpDisplayName è troppo piccolo, questa variabile contiene le dimensioni necessarie.
[out] lpLanguageId
Puntatore a una variabile che riceve l'identificatore della lingua per il nome visualizzato restituito.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.
Commenti
La funzione LookupPrivilegeDisplayName recupera i nomi visualizzati solo per i privilegi specificati nella sezione Privilegi definiti di Winnt.h.
Nota
L'intestazione winbase.h definisce LookupPrivilegeDisplayName come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.
Requisiti
| Client minimo supportato | Windows XP [app desktop | App UWP] |
| Server minimo supportato | Windows Server 2003 [app desktop | App UWP] |
| Piattaforma di destinazione | Windows |
| Intestazione | winbase.h (include Windows.h) |
| Libreria | Advapi32.lib |
| DLL | Advapi32.dll |
Vedi anche
Panoramica Controllo di accesso