Funzione FwpmCalloutAdd0 (fwpmu.h)

  • Articolo

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