Funzione FwpsCalloutUnregisterById0 (fwpsk.h)
La funzione FwpsCalloutUnregisterById0 annulla la registrazione di un callout dal motore di filtro.
Sintassi
NTSTATUS FwpsCalloutUnregisterById0(
[in] const UINT32 calloutId
);
Parametri
[in] calloutId
Identificatore di runtime per il callout che viene annullata la registrazione dal motore di filtro. Deve trattarsi dell'identificatore di runtime restituito quando il driver di callout ha chiamato la funzione FwpsCalloutRegister0 o FwpsCalloutRegister1 per registrare il callout con il motore di filtro.
Valore restituito
La funzione FwpsCalloutUnregisterById0 restituisce uno dei codici NTSTATUS seguenti.
Codice restituito | Descrizione |
---|---|
|
Il callout è stato annullato correttamente dalla registrazione dal motore di filtro. |
|
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 FwpsCalloutUnregisterById0 per completare la registrazione del callout dal motore di filtro. |
|
Non esiste un callout registrato con il motore di filtro che corrisponde all'identificatore di runtime specificato nel parametro calloutId . |
|
Il callout è già in fase di registrazione o annullamento della registrazione in un altro thread. |
|
Si è verificato un errore. |
Commenti
Un driver callout chiama la funzione FwpsCalloutUnregisterById0 per annullare la registrazione di un callout dal motore di filtro, usando l'identificatore di runtime per identificare il callout da annullare. 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
Requisito | Valore |
---|---|
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 |