Condividi tramite

Funzione FwpsOpenToken0 (fwpsu.h)

  • Articolo

Apre un token di accesso.

Nota

FwpsOpenToken0 è una versione specifica di FwpsOpenToken. Per altre informazioni, vedere Nomi indipendenti dalla versione del WFP e destinazione 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 viene modificato il token. Un'applicazione può usare questo valore come test del fatto che un contesto di sicurezza è stato modificato dall'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 degli accessi discrezionali del token per determinare quali accessi vengono concessi o negati.

accessToken

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

Valore restituito

La funzione FwpsOpenToken0 restituisce uno dei codici NTSTATUS seguenti.

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

Requisiti

Requisito Valore
Intestazione fwpsu.h