Funzione FwpmIPsecTunnelAdd1 (fwpmk.h)

Articolo
07/16/2024

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

Sintassi

NTSTATUS FwpmIPsecTunnelAdd1(
  [in]           HANDLE                       engineHandle,
  [in]           UINT32                       flags,
  [in, optional] const FWPM_PROVIDER_CONTEXT1 *mainModePolicy,
  [in]           const FWPM_PROVIDER_CONTEXT1 *tunnelPolicy,
  [in]           UINT32                       numFilterConditions,
  [in]           const FWPM_FILTER_CONDITION0 *filterConditions,
  [in, optional] const GUID                   *keyModKey,
  [in, optional] PSECURITY_DESCRIPTOR         sd
);

Parametri

[in] engineHandle

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

[in] flags

Valori possibili:

Flag 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

Criterio modalità principale per il tunnel IPsec.

[in] tunnelPolicy

Criterio modalità rapida per il tunnel IPsec.

[in] numFilterConditions

Numero di condizioni di filtro presenti nel parametro filterConditions.

[in] filterConditions

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

[in, optional] keyModKey

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, si applicano i criteri di keying predefiniti.

[in, optional] sd

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 WFP.
*RPC_ codice di errore** 0x80010001: 0x80010122	Errore di comunicazione con il motore firewall remoto o locale.
Altri codici NTSTATUS	Si è verificato un errore.

Osservazioni

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

FwpmIPsecTunnelAdd1 è un'implementazione specifica di FwpmIPsecTunnelAdd. 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
libreria	fwpkclnt.lib
IRQL	<= PASSIVE_LEVEL

Vedere anche

FWPM_FILTER_CONDITION0
FWPM_PROVIDER_CONTEXT1
codici di errore WFP
gestione oggetti di
nomi Version-Independent WFP e selezione di versioni specifiche di Windows

Condividi tramite