Condividi tramite

Funzione FwpmCalloutDeleteByKey0 (fwpmk.h)

  • Articolo

La funzione FwpmCalloutDeleteByKey0 elimina un callout dal motore di filtro.

Sintassi

NTSTATUS FwpmCalloutDeleteByKey0(
  [in] HANDLE     engineHandle,
  [in] const GUID *key
);

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] key

Puntatore a un GUID che identifica in modo univoco il callout che viene eliminato dal motore di filtro. Deve essere un puntatore allo stesso GUID specificato quando il driver del callout ha chiamato la funzione FwpmCalloutAdd0 per aggiungere il callout al motore di filtro.

Valore restituito

La funzione FwpmCalloutDeleteByKey0 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 al GUID specificato nel parametro chiave.
Altri codici NTSTATUS Si è verificato un errore.

Osservazioni

Un driver callout chiama la funzione FwpmCalloutDeleteByKey0 per eliminare un callout dal motore di filtro, usando la chiave GUID 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.

FwpmCalloutDeleteByKey0 è una versione specifica di FwpmCalloutDeleteByKey. 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