Funzione FwpsOpenToken0 (fwpsk.h)

Articolo
02/07/2025

La funzione FwpsOpenToken0 apre un token di accesso.

NotaFwpsOpenToken0 è una versione specifica di FwpsOpenToken. Per altre informazioni, vedere nomi Version-Independent WFP e selezione di versioni specifiche di Windows.

Sintassi

NTSTATUS FwpsOpenToken0(
  [in]  IN HANDLE  engineHandle,
  [in]  IN LUID    modifiedId,
  [in]  IN DWORD   desiredAccess,
  [out] OUT HANDLE *accessToken
);

Parametri

[in] 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.

[in] 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.

[in] 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 del token (DACL) per determinare quali accessi vengono concessi o negati.

[out] 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	Descrizione
STATUS_SUCCESS	Il token di accesso è stato aperto correttamente.
Altri codici di stato	Si è verificato un errore.

Osservazioni

Il processo che chiama fwpsopentoken0 deve disporre del privilegio SE_DEBUG_NAME abilitato nel token di processo.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile a partire da Windows 7.
piattaforma di destinazione	Universale
intestazione	fwpsk.h (include Fwpsk.h)
IRQL	<= PASSIVE_LEVEL

Vedere anche

FwpmEngineOpen0

Condividi tramite