Funzione FwpmCalloutDeleteById0 (fwpmk.h)

La funzione FwpmCalloutDeleteById0 elimina un callout dal motore di filtro.

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

 

Sintassi

NTSTATUS FwpmCalloutDeleteById0(
  [in] HANDLE engineHandle,
  [in] UINT32 id
);

Parametri

[in] engineHandle

Handle per una sessione aperta al motore di filtro. Un driver callout chiama la funzione FwpmEngineOpen0 per aprire una sessione al motore di filtro.

[in] id

Identificatore di runtime per il callout eliminato dal motore di filtro. Questo deve essere l'identificatore di runtime restituito quando il driver callout ha chiamato la funzione FwpmCalloutAdd0 per aggiungere il callout al motore di filtro.

Valore restituito

La funzione FwpmCalloutDeleteById0 restituisce uno dei codici NTSTATUS seguenti.

Codice restituito	Descrizione
STATUS_SUCCESS	Il callout è stato eliminato correttamente dal motore di filtro.
STATUS_FWP_IN_USE	Uno o più filtri nel motore di filtro specificano il callout per l'azione del filtro.
STATUS_FWP_CALLOUT_NOT_FOUND	Non esiste un callout nel motore di filtro che corrisponde all'identificatore di runtime specificato nel parametro ID .
Altri codici di stato	Si è verificato un errore.

Commenti

Un driver di callout chiama la funzione FwpmCalloutDeleteById0 per eliminare un callout dal motore di filtro usando l'identificatore di runtime per identificare il callout da eliminare.

I driver di callout non eliminano in genere i callout dal motore di filtro. Nella maggior parte delle situazioni, questa operazione viene gestita da un'applicazione di gestione della piattaforma di filtro windows in modalità utente.

Un callout può essere eliminato dal motore di filtro solo se non sono presenti filtri nel motore di filtro che specificano il callout per l'azione del filtro.

Requisiti

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

Vedi anche

FwpmCalloutAdd0

FwpmCalloutDeleteByKey0

FwpmEngineOpen0