Compartir a través de

Función FwpmIPsecTunnelAdd1 (fwpmu.h)

  • Artículo

La función FwpmIPsecTunnelAdd1 agrega una nueva directiva de modo de túnel de seguridad de protocolo de Internet (IPsec) al sistema.

NotaFwpmIPsecTunnelAdd1 es la implementación específica de FwpmIPsecTunnelAdd usada en Windows 7. Para obtener más información, vea NOMBRES DE Version-Independent DE PMA y versiones específicas de Windows dirigidas a destinatarios. Para Windows Vista, FwpmIPsecTunnelAdd0 está disponible. Para Windows 8, FwpmIPsecTunnelAdd2 está disponible.
 

Sintaxis

DWORD 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
);

Parámetros

[in] engineHandle

Tipo: HANDLE

Identificador de una sesión abierta en el motor de filtro. Llame a FwpmEngineOpen0 para abrir una sesión en el motor de filtro.

[in] flags

Tipo: UINT32

Valores posibles:

Marca de túnel IPsec Significado
FWPM_TUNNEL_FLAG_POINT_TO_POINT
 Agrega un túnel de punto a punto al sistema.
FWPM_TUNNEL_FLAG_ENABLE_VIRTUAL_IF_TUNNELING
 Habilita el modo de túnel IPsec basado en interfaz virtual.

[in, optional] mainModePolicy

Tipo: FWPM_PROVIDER_CONTEXT1*

Directiva de modo principal para el túnel IPsec.

[in] tunnelPolicy

Tipo: FWPM_PROVIDER_CONTEXT1*

Directiva de modo rápido para el túnel IPsec.

[in] numFilterConditions

Tipo: UINT32

Número de condiciones de filtro presentes en el parámetro filterConditions .

[in] filterConditions

Tipo: const FWPM_FILTER_CONDITION0*

Matriz de condiciones de filtro que describen el tráfico que debe tunelizar IPsec.

[in, optional] keyModKey

Tipo: GUID const*

Puntero a un GUID que identifica de forma única la clave del módulo de creación de claves.

Si el autor de la llamada proporciona este parámetro, solo se usará ese módulo de creación de claves para el túnel. De lo contrario, se aplica la directiva de creación de claves predeterminada.

[in, optional] sd

Tipo: PSECURITY_DESCRIPTOR

Información de seguridad asociada al túnel IPsec.

Valor devuelto

Tipo: DWORD

Código o valor devuelto Descripción
ERROR_SUCCESS
0
 La directiva de modo de túnel IPsec se agregó correctamente.
FWP_E_INVALID_PARAMETER
0x80320035
 FWPM_TUNNEL_FLAG_POINT_TO_POINT no se estableció y se especificaron condiciones distintas de la dirección local o remota.
código de error FWP_E_*
0x80320001: 0x80320039
 Error específico de la Plataforma de filtrado de Windows (PMA). Consulte Códigos de error de PMA para obtener más información.
RPC_* código de error*
0x80010001: 0x80010122
 Error al comunicarse con el motor de firewall remoto o local.

Comentarios

No se puede llamar a esta función desde dentro de una transacción de solo lectura. Se producirá un error con FWP_E_INCOMPATIBLE_TXN. Consulte Administración de objetos para obtener más información sobre las transacciones.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado fwpmu.h
Library Fwpuclnt.lib
Archivo DLL Fwpuclnt.dll

Consulte también

FWPM_FILTER_CONDITION0

FWPM_PROVIDER_CONTEXT1