Funzione FwpmCalloutAdd0 (fwpmu.h)

Articolo
02/28/2024

La funzione FwpmCalloutAdd0 aggiunge un nuovo oggetto callout al sistema.

Sintassi

DWORD FwpmCalloutAdd0(
  [in]            HANDLE               engineHandle,
  [in]            const FWPM_CALLOUT0  *callout,
  [in, optional]  PSECURITY_DESCRIPTOR sd,
  [out, optional] UINT32               *id
);

Parametri

[in] engineHandle

Tipo: HANDLE

Handle per una sessione aperta al motore di filtro. Chiamare FwpmEngineOpen0 per aprire una sessione al motore di filtro.

[in] callout

Tipo: FWPM_CALLOUT0*

Oggetto callout da aggiungere.

[in, optional] sd

Tipo: PSECURITY_DESCRIPTOR

Informazioni sulla sicurezza associate al callout.

[out, optional] id

Tipo: UINT32*

Identificatore di runtime per questo callout.

Valore restituito

Tipo: DWORD

Codice/valore restituito	Descrizione
ERROR_SUCCESS 0	Il callout è stato aggiunto correttamente.
FWP_E_INVALID_PARAMETER 0x80320035	FWPM_TUNNEL_FLAG_POINT_TO_POINT non è stato impostato e non sono state specificate condizioni diverse dall'indirizzo locale/remoto.
*FWP_E_ codice di errore** 0x80320001: 0x80320039	Errore specifico di Windows Filtering Platform (WFP). Per informazioni dettagliate, vedere Codici di errore WFP .
*RPC_ codice di errore** 0x80010001: 0x80010122	Non è possibile comunicare con il motore firewall remoto o locale.

Commenti

Alcuni campi nella struttura FWPM_CALLOUT0 vengono assegnati dal sistema, non dal chiamante e vengono ignorati nella chiamata a FwpmCalloutAdd0. Se il chiamante fornisce un descrittore di sicurezza Null, il sistema assegna un descrittore di sicurezza predefinito.

Questa funzione non può essere chiamata dall'interno di una transazione di sola lettura. Avrà esito negativo con FWP_E_INCOMPATIBLE_TXN. Per altre informazioni sulle transazioni, vedere Gestione oggetti .

Il chiamante deve FWPM_ACTRL_ADD l'accesso al contenitore del callout, FWPM_ACTRL_ADD_LINK l'accesso al provider (se presente) e FWPM_ACTRL_ADD_LINK l'accesso al livello applicabile. Per altre informazioni, vedere Controllo di accesso.

Per aggiungere un filtro che fa riferimento a un callout, richiamare le funzioni nell'ordine seguente.

Chiamare FwpsCalloutRegister (documentato in Windows Driver Kit (WDK) per registrare il callout con il motore di filtro.
Chiamare FwpmCalloutAdd0 per aggiungere il callout al sistema.
Chiamare FwpmFilterAdd0 per aggiungere il filtro che fa riferimento al callout al sistema.

Per impostazione predefinita, i filtri che fanno riferimento ai callout aggiunti, ma non sono ancora stati registrati con il motore di filtro vengono considerati filtri blocca.

FwpmCalloutAdd0 è un'implementazione specifica di FwpmCalloutAdd. Per altre informazioni , vedere Nomi Version-Independent WFP e Versioni specifiche di Windows .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	fwpmu.h
Libreria	Fwpuclnt.lib
DLL	Fwpuclnt.dll

Vedi anche

FWPM_CALLOUT0

FwpmCallout in modalità kernelAggiungi

Condividi tramite