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
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 FwpsCalloutUnregisterById0 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 all'identificatore di runtime specificato nel parametro calloutId .
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 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

Vedi anche

FwpsCalloutRegister0

FwpsCalloutRegister1

FwpsCalloutUnregisterByKey0

FwpsFlowRemoveContext0

Tipi di callout