Condividi tramite

Funzione FwpmCalloutAdd0 (fwpmk.h)

  • Articolo

La funzione FwpmCalloutAdd0 aggiunge un callout al motore di filtro.

Sintassi

NTSTATUS FwpmCalloutAdd0(
  [in]            HANDLE               engineHandle,
  [in]            const FWPM_CALLOUT0  *callout,
  [in, optional]  PSECURITY_DESCRIPTOR sd,
  [out, optional] 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] callout

Puntatore a una struttura di FWPM_CALLOUT0 costante che contiene i dati necessari per aggiungere il callout al motore di filtro.

[in, optional] sd

Puntatore a una struttura SECURITY_DESCRIPTOR costante che descrive il descrittore di sicurezza per il callout che viene aggiunto al motore di filtro. Questo parametro è facoltativo e può essere NULL.

[out, optional] id

Puntatore a una variabile tipizzata UINT32 che riceve un identificatore di runtime che identifica il callout nel motore di filtro. Si tratta dello stesso identificatore restituito quando un driver callout registra le funzioni callout del driver del callout con il motore di filtro. Il driver callout passa questo identificatore alla funzione FwpmCalloutDeleteById0 quando si rimuove il callout dal motore di filtro. Questo parametro è facoltativo e può essere NULL.

Valore restituito

La funzione FwpmCalloutAdd0 restituisce uno dei codici NTSTATUS seguenti:

Codice restituito Descrizione
STATUS_SUCCESS Il callout è stato aggiunto correttamente al motore di filtro.
STATUS_FWP_ALREADY_EXISTS Impossibile aggiungere il callout al motore di filtro. Un callout esiste già nel motore di filtro con un identificatore identico al GUID specificato nel membro calloutKey della struttura FWPM_CALLOUT0 a cui punta il callout parametro.
Altri codici NTSTATUS Si è verificato un errore.

Osservazioni

Un driver callout chiama la funzione FwpmCalloutAdd0 per aggiungere un callout al motore di filtro.

I driver callout in genere non aggiungono i callout al motore di filtro. Nella maggior parte dei casi questa operazione viene gestita da un'applicazione di gestione della piattaforma di filtro Windows in modalità utente.

È possibile aggiungere un callout e filtri che specificano il callout per l'azione del filtro al motore di filtro prima che un driver callout registri il callout con il motore di 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 fino a quando il callout non viene registrato con il motore di filtro.

FwpmCalloutAdd0 è una versione specifica di FwpmCalloutAdd. 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