Funzione FwpsCalloutUnregisterByKey0 (fwpsk.h)

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

 

Sintassi

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

Parametri

[in] calloutKey

Puntatore a un GUID che identifica in modo univoco il callout che viene annullata dalla registrazione dal motore di filtro. Deve trattarsi di un puntatore allo stesso GUID specificato quando il driver del callout chiamato le funzioni 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 dalla registrazione 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 che il contesto è stato rimosso correttamente da ognuno di questi flussi di dati, il driver del callout deve chiamare di nuovo 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_TERMINATING o FWP_ACTION_CALLOUT_UNKNOWN vengono considerati come FWP_ACTION_BLOCK e i filtri con un tipo di azione di FWP_ACTION_CALLOUT_INSPECTION vengono ignorati dopo che il callout è stato annullato dalla registrazione 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 non sono stati registrati correttamente.

Requisiti

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

Vedi anche

FwpsCalloutRegister0

FwpsCalloutRegister1

FwpsCalloutUnregisterById0

FwpsFlowRemoveContext0

Tipi di callout