Funzione FwpsOpenToken0 (fwpsk.h)

Articolo
08/07/2023

La funzione FwpsOpenToken0 apre un token di accesso.

NotaFwpsOpenToken0 è una versione specifica di FwpsOpenToken. Per altre informazioni, vedere Wfp Version-Independent Names and Targeting Specific Versions of Windows .See WFP Version-Independent Names and Targeting Specific Versions of Windows.See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information.

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 DACL (Discretionary Access Control List) del token 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.

Requisiti

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

Vedi anche

FwpmEngineOpen0

Condividi tramite