Funzione FwpsAcquireClassifyHandle0 (fwpsk.h)

Articolo
02/07/2025

La funzione FwpsAcquireClassifyHandle0 genera un handle di classificazione usato per identificare le operazioni di classificazione asincrone e le richieste di dati del livello scrivibili.

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

Sintassi

NTSTATUS FwpsAcquireClassifyHandle0(
  [in]  void   *classifyContext,
  [in]  UINT32 flags,
  [out] UINT64 *classifyHandle
);

Parametri

[in] classifyContext

Parametro di classifyContext da classifyFn1. Il motore WFP passa questo valore al driver callout classificareFn.

[in] flags

Riservato per uso futuro. Impostare su 0.

[out] classifyHandle

Puntatore a una variabile che riceve un handle di classificazione. Questo handle è necessario per le chiamate di funzione successive, come indicato in Osservazioni.

Valore restituito

La funzione fwpsAcquireClassifyHandle0 restituisce uno dei codici NTSTATUS seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	È stato restituito un handle per la richiesta di classificazione. La variabile a cui punta il parametro classifyHandle contiene l'handle per la richiesta di classificazione.
Altri codici di stato	Si è verificato un errore.

Osservazioni

FwpsAcquireClassifyHandle0 è una funzione di supporto per la classificazione asincrona e la modifica dei dati. L'handle restituito da questa funzione è obbligatorio come parametro per le funzioni seguenti:

Per ogni chiamata a questa funzione, il driver callout deve chiamare FwpsReleaseClassifyHandle0 per liberare le risorse di sistema associate all'handle.

Fabbisogno

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

Vedere anche

FwpsCompleteClassify0

FwpsPendClassify0

FwpsReleaseClassifyHandle0

classificareFn

classifyFn1

Condividi tramite