Condividi tramite


Funzione FwpsOpenToken0 (fwpsu.h)

Apre un token di accesso.

Annotazioni

FwpsOpenToken0 è una versione specifica di FwpsOpenToken. Per altre info, vedi Nomi indipendenti dalla versione del WFP e targeting di versioni specifiche di Windows.

Sintassi

DWORD FwpsOpenToken0(
  HANDLE engineHandle,
  LUID   modifiedId,
  DWORD  desiredAccess,
  HANDLE *accessToken
);

Parametri

engineHandle

Handle per una sessione aperta al motore di filtro. Un driver callout chiama la funzione FwpmEngineOpen0 per aprire una sessione al motore di filtro.

modifiedId

Specifica un LUID che cambia ogni volta che il token viene modificato. Un'applicazione può usare questo valore come test per verificare se un contesto di sicurezza è stato modificato dopo l'ultimo utilizzo.

desiredAccess

ACCESS_MASK struttura che specifica i tipi richiesti di accesso al token di accesso. Questi tipi di accesso richiesti vengono confrontati con l'elenco di controllo di accesso discrezionale (DACL) del token per determinare quali accessi vengono concessi o negati.

accessToken

Puntatore a una variabile allocata dal chiamante che riceve un handle per il token di accesso appena aperto.

Valore restituito

La funzione FwpsOpenToken0 restituisce uno dei codici NTSTATUS seguenti.

Codice restituito Description
STATUS_SUCCESS Il token di accesso è stato aperto correttamente.
Altri codici di stato Si è verificato un errore.

Requisiti

Requisito Value
Header fwpsu.h
Library fwpuclnt.lib