Funzione LookupPrivilegeValueA (winbase.h)

La funzione LookupPrivilegeValue recupera l'identificatore univoco locale (LUID) usato in un sistema specificato per rappresentare localmente il nome dei privilegi specificato.

Sintassi

BOOL LookupPrivilegeValueA(
  [in, optional] LPCSTR lpSystemName,
  [in]           LPCSTR lpName,
  [out]          PLUID  lpLuid
);

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] lpName

Puntatore a una stringa con terminazione null che specifica il nome del privilegio, come definito nel file di intestazione Winnt.h. Ad esempio, questo parametro potrebbe specificare la costante, SE_SECURITY_NAME o la relativa stringa corrispondente, "SeSecurityPrivilege".

[out] lpLuid

Puntatore a una variabile che riceve il LUID in base al quale il privilegio è noto nel sistema specificato dal parametro lpSystemName .

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 informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

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

Esempio

Per un esempio che usa questa funzione, vedere Abilitazione e disabilitazione dei privilegi.

Nota

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

Requisito Valore
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

Controllo dell’accesso

Funzioni di base Controllo di accesso

LookupPrivilegeDisplayName

LookupPrivilegeName