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 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 |
|---|---|
|
Il callout è stato annullato correttamente 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 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. |
|
Non esiste un callout registrato con il motore di filtro che corrisponde al GUID specificato nel parametro calloutKey . |
|
Il callout è già in fase di registrazione o annullamento della registrazione in un altro thread. |
|
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 |