Funzione LookupPrivilegeValueA (winbase.h)
La funzione LookupPrivilegeValue
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 può specificare la costante, SE_SECURITY_NAME o la stringa corrispondente, "SeSecurityPrivilege".
[out] lpLuid
Puntatore a una variabile che riceve il LUID tramite cui 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 ottenere informazioni estese sull'errore, chiamare GetLastError.
Osservazioni
La funzione LookupPrivilegeValue supporta solo i privilegi specificati nella sezione Privilegi definiti di Winnt.h. Per un elenco di valori, vedere Costanti privilegio.
Esempi
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 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 |