Funzione LookupPrivilegeDisplayNameW (winbase.h)

Articolo
11/20/2024

La funzione LookupPrivilegeDisplayName recupera il nome visualizzato che rappresenta un privilegio specificato.

Sintassi

BOOL LookupPrivilegeDisplayNameW(
  [in, optional]  LPCWSTR lpSystemName,
  [in]            LPCWSTR lpName,
  [out, optional] LPWSTR  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 può specificare la costante, SE_REMOTE_SHUTDOWN_NAME o la stringa corrispondente, "SeRemoteShutdownPrivilege". Per un elenco di valori, vedere Costanti privilegio.

[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 arresto da un sistema remoto".

[in, out] cchDisplayName

Puntatore a una variabile che specifica le dimensioni, in TCHARs, del buffer lpDisplayName . Quando la funzione viene restituita, questo parametro contiene la lunghezza del nome visualizzato dei privilegi, non incluso il carattere null di terminazione. Se il buffer a cui punta il 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 ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

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 del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [app desktop \| App UWP]
server minimo supportato	Windows Server 2003 [app desktop \| App UWP]
piattaforma di destinazione	Finestre
intestazione	winbase.h (include Windows.h)
libreria	Advapi32.lib
dll	Advapi32.dll

Vedere anche

Panoramica del controllo di accesso

funzioni di controllo di accesso di base

LookupPrivilegeName

LookupPrivilegeValue

Condividi tramite