Funzione FwpsAcquireClassifyHandle0 (fwpsk.h)

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

Sintassi

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

Parametri

[in] classifyContext

Parametro classifyContext da classificazioneFn1. Il motore WFP passa questo valore al callout driver classificatoFn.

[in] flags

Riservato per utilizzi futuri. Impostare su 0.

[out] classifyHandle

Puntatore a una variabile che riceve un handle di classificazione. Questo handle è necessario dalle 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 alla richiesta di classificazione. Variabile che il parametro classifyHandle punta a contiene l'handle per la richiesta di classificazione.
Altri codici di stato	Si è verificato un errore.

Commenti

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

• FwpsPendClassify0

• FwpsAcquireWritableLayerDataPointer0
• FwpsApplyModifiedLayerData0

• FwpsCompleteClassify0

• FwpsReleaseClassifyHandle0

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

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile a partire da Windows 7.
Piattaforma di destinazione	Universale
Intestazione	fwpsk.h (includere Fwpsk.h)
Libreria	Fwpkclnt.lib
IRQL	<= DISPATCH_LEVEL

Vedi anche

FwpsCompleteClassify0

FwpsPendClassify0

FwpsReleaseClassifyHandle0

classificazioneFn

classificazioneFn1