Condividi tramite

Funzione FwpmCalloutDeleteById0 (fwpmk.h)

  • Articolo

La funzione FwpmCalloutDeleteById0 elimina un callout dal motore di filtro.

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 che viene eliminato dal motore di filtro. Deve essere l'identificatore di runtime restituito quando il driver del 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 NTSTATUS Si è verificato un errore.

Osservazioni

Un driver 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 callout in genere non eliminano i callout dal motore di filtro. Nella maggior parte dei casi, questo viene gestito da un'applicazione di gestione di gestione in modalità utente windows Filtering Platform.

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.

FwpmCalloutDeleteById0 è una versione specifica di FwpmCalloutDeleteById. Per altre informazioni, vedere nomi Version-Independent WFP e selezione di versioni specifiche di Windows.

Fabbisogno

Requisito Valore
client minimo supportato Disponibile a partire da Windows Vista.
piattaforma di destinazione Universale
intestazione fwpmk.h (include Fwpmk.h)
libreria Fwpkclnt.lib
IRQL PASSIVE_LEVEL

Vedere anche