Funzione FwpsCalloutUnregisterByKey0 (fwpsk.h)

La funzione FwpsCalloutUnregisterByKey0 annulla la registrazione di un callout dal motore di filtro.

NotaFwpsCalloutUnregisterByKey0 è una versione specifica di FwpsCalloutUnregisterByKey. Per altre informazioni , vedere Nomi Version-Independent WFP e Versioni specifiche di Windows .

 

Sintassi

NTSTATUS FwpsCalloutUnregisterByKey0(
  [in] const GUID *calloutKey
);

Parametri

[in] calloutKey

Puntatore a un GUID che identifica in modo univoco il callout non registrato dal motore di filtro. Questo deve essere un puntatore alla stessa GUID specificata quando il driver di callout chiama fwpsCalloutRegister0 o FwpsCalloutRegister1 per registrare il callout con il motore di filtro.

Valore restituito

La funzione FwpsCalloutUnregisterByKey0 restituisce uno dei codici NTSTATUS seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	Il callout è stato annullato correttamente dal motore di filtro.
STATUS_DEVICE_BUSY	Esistono uno o più flussi di dati elaborati dal callout che hanno un contesto in sospeso associato al flusso di dati. Un driver di callout deve chiamare la funzione FwpsFlowRemoveContext0 per ognuno di questi flussi di dati per rimuovere il contesto associato. Dopo aver rimosso correttamente il contesto da ognuno di questi flussi di dati, il driver di callout deve chiamare nuovamente la funzione FwpsCalloutUnregisterByKey0 per completare la registrazione del callout dal motore di filtro.
STATUS_FWP_CALLOUT_NOT_FOUND	Non esiste un callout registrato con il motore di filtro che corrisponde al GUID specificato nel parametro calloutKey .
STATUS_FWP_IN_USE	Il callout è già in fase di registrazione o annullamento della registrazione in un altro thread.
Altri codici di stato	Si è verificato un errore.

Commenti

Un driver di callout chiama la funzione FwpsCalloutUnregisterByKey0 per annullare la registrazione di un callout dal motore di filtro, usando la chiave GUID per identificare il callout da annullare la registrazione. Questa funzione ha esito positivo anche se nel motore di filtro sono presenti filtri che specificano il callout per l'azione del filtro. In questo caso, i filtri con un tipo di azione di FWP_ACTION_CALLOUT_TERMINATINGo FWP_ACTION_CALLOUT_UNKNOWN vengonoconsiderati FWP_ACTION_BLOCK e i filtri con un tipo di azione di FWP_ACTION_CALLOUT_INSPECTION vengono ignorati dopo che il callout è stato deregisterato dal motore di filtro.

Non è possibile scaricare un driver di callout fino a quando tutti i callout registrati in precedenza con il motore di filtro sono stati annullati correttamente.

Requisiti

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

Vedi anche

FwpsCalloutRegister0

FwpsCalloutRegister1

FwpsCalloutUnregisterById0

FwpsFlowRemoveContext0

Tipi di callout