Funzione FwpmIPsecTunnelAdd2 (fwpmu.h)

Articolo
08/23/2023

La funzione FwpmIPsecTunnelAdd2 aggiunge un nuovo criterio di modalità tunnel IPsec (Internet Protocol Security) al sistema.

NotaFwpmIPsecTunnelAdd2 è l'implementazione specifica di FwpmIPsecTunnelAdd usata in Windows 8. Per altre informazioni, vedere Wfp Version-Independent Names and Targeting Specific Versions of Windows .See WFP Version-Independent Names and Targeting Specific Versions of Windows.See WFP Version-Independent Names and Targeting Specific Versions of Windows for more information. Per Windows 7 è disponibile FwpmIPsecTunnelAdd1 . Per Windows Vista, è disponibile FwpmIPsecTunnelAdd0 .

Sintassi

DWORD FwpmIPsecTunnelAdd2(
  [in]           HANDLE                       engineHandle,
  [in]           UINT32                       flags,
  [in, optional] const FWPM_PROVIDER_CONTEXT2 *mainModePolicy,
  [in]           const FWPM_PROVIDER_CONTEXT2 *tunnelPolicy,
  [in]           UINT32                       numFilterConditions,
  [in]           const FWPM_FILTER_CONDITION0 *filterConditions,
  [in, optional] const GUID                   *keyModKey,
  [in, optional] PSECURITY_DESCRIPTOR         sd
);

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

Tipo: UINT32

Valori possibili:

Flag del tunnel IPsec	Significato
FWPM_TUNNEL_FLAG_POINT_TO_POINT	Aggiunge un tunnel da punto a punto al sistema.
FWPM_TUNNEL_FLAG_ENABLE_VIRTUAL_IF_TUNNELING	Abilita la modalità tunnel IPsec basata su interfaccia virtuale.

[in, optional] mainModePolicy

Tipo: FWPM_PROVIDER_CONTEXT2*

Criterio modalità principale per il tunnel IPsec.

[in] tunnelPolicy

Tipo: FWPM_PROVIDER_CONTEXT2*

Criterio modalità rapida per il tunnel IPsec.

[in] numFilterConditions

Tipo: UINT32

Numero di condizioni di filtro presenti nel parametro filterConditions .

[in] filterConditions

Tipo: FWPM_FILTER_CONDITION0*

Matrice di condizioni di filtro che descrivono il traffico che deve essere sottoposto a tunneling da IPsec.

[in, optional] keyModKey

Tipo: GUID const*

Puntatore a un GUID che identifica in modo univoco la chiave del modulo di keying.

Se il chiamante fornisce questo parametro, verrà usato solo il modulo di keying per il tunnel. In caso contrario, viene applicato il criterio di keying predefinito.

[in, optional] sd

Tipo: PSECURITY_DESCRIPTOR

Informazioni di sicurezza associate al tunnel IPsec.

Valore restituito

Tipo: DWORD

Codice/valore restituito	Descrizione
ERROR_SUCCESS 0	I criteri della modalità tunnel IPsec sono stati aggiunti correttamente.
FWP_E_INVALID_PARAMETER 0x80320035	FWPM_TUNNEL_FLAG_POINT_TO_POINT non è stato impostato e 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 del WFP .
*RPC_ codice di errore** 0x80010001: 0x80010122	Errore di comunicazione con il motore firewall remoto o locale.

Commenti

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

Requisiti


Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	fwpmu.h
Libreria	Fwpuclnt.lib
DLL	Fwpuclnt.dll

Vedi anche

FWPM_FILTER_CONDITION0

FWPM_PROVIDER_CONTEXT2

Funzioni WFP

Informazioni di riferimento sulle API windows Filtering Platform

Condividi tramite