Funzione FwpmIPsecTunnelAdd0 (fwpmu.h)

Articolo
08/23/2023

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

NotaFwpmIPsecTunnelAdd0 è l'implementazione specifica di FwpmIPsecTunnelAdd usato in Windows Vista. Per altre informazioni , vedere Nomi Version-Independent WFP e Versioni specifiche di Windows . Per Windows 7, FwpmIPsecTunnelAdd1 è disponibile. Per Windows 8, FwpmIPsecTunnelAdd2 è disponibile.

Sintassi

DWORD FwpmIPsecTunnelAdd0(
  [in]           HANDLE                       engineHandle,
  [in]           UINT32                       flags,
  [in, optional] const FWPM_PROVIDER_CONTEXT0 *mainModePolicy,
  [in]           const FWPM_PROVIDER_CONTEXT0 *tunnelPolicy,
  [in]           UINT32                       numFilterConditions,
  [in]           const FWPM_FILTER_CONDITION0 *filterConditions,
  [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 tunnel IPsec	Significato
FWPM_TUNNEL_FLAG_POINT_TO_POINT	Aggiunge un tunnel da punto a punto al sistema.

[in, optional] mainModePolicy

Tipo: FWPM_PROVIDER_CONTEXT0*

Criterio della modalità principale per il tunnel IPsec.

[in] tunnelPolicy

Tipo: FWPM_PROVIDER_CONTEXT0*

Criteri di 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 tunnelato da IPsec.

[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 di modalità tunnel IPsec sono stati aggiunti 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

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 .

Requisiti


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_FILTER_CONDITION0

FWPM_PROVIDER_CONTEXT0

Condividi tramite