Funzione LookupPrivilegeNameA (winbase.h)

Articolo
11/20/2024

La funzione LookupPrivilegeName recupera il nome che corrisponde al privilegio rappresentato in un sistema specifico da un identificatore univoco locale specificato (LUID).

Sintassi

BOOL LookupPrivilegeNameA(
  [in, optional]  LPCSTR  lpSystemName,
  [in]            PLUID   lpLuid,
  [out, optional] LPSTR   lpName,
  [in, out]       LPDWORD cchName
);

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 del privilegio nel sistema locale.

[in] lpLuid

Puntatore al LUID in base al quale il privilegio è noto nel sistema di destinazione.

[out, optional] lpName

Puntatore a un buffer che riceve una stringa con terminazione Null che rappresenta il nome del privilegio. Ad esempio, questa stringa potrebbe essere "SeSecurityPrivilege".

[in, out] cchName

Puntatore a una variabile che specifica le dimensioni, in un valore di TCHAR , del buffer lpName. Quando la funzione termina, questo parametro contiene la lunghezza del nome del privilegio, senza includere il carattere Null di terminazione. Se il buffer a cui punta il parametro lpName è troppo piccolo, questa variabile contiene le dimensioni necessarie.

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce un valore diverso da zero.

Se la funzione ha esito negativo, restituisce zero. Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

La funzione LookupPrivilegeName supporta solo i privilegi specificati nella sezione Privilegi definiti di Winnt.h. Per un elenco di valori, vedere Costanti privilegio.

Nota

L'intestazione winbase.h definisce LookupPrivilegeName 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

controllo di accesso

funzioni di controllo di accesso di base

LookupPrivilegeDisplayName

LookupPrivilegeValue

Condividi tramite