Compartir a través de

Función FwpmIPsecTunnelAdd3 (fwpmk.h)

  • Artículo

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

Sintaxis

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

Parámetros

[in] engineHandle

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

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

Directiva de modo principal opcional para el túnel IPsec.

[in] tunnelPolicy

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

[in] numFilterConditions

Número de condiciones de filtro presentes en filterConditions.

[in, reads(numFilterConditions)] filterConditions

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

[in, optional] keyModKey

Puntero opcional a un GUID que identifica de forma única la clave del módulo de creación de claves. Si 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 clave predeterminada.

[in, optional] sd

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

Valor devuelto

Código y valor devueltos 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.
FWP_E_* de código de error
0x80320001: 0x80320039		 Error específico de la Plataforma de filtrado de Windows (PMA). Para obtener más información, consulte códigos de error del PMA.
RPC_* código de error
0x80010001: 0x80010122		 Error al comunicarse con el motor de firewall remoto o local.
otros códigos NTSTATUS Error.

Observaciones

No se puede llamar a esta función dentro de una transacción de solo lectura, se produce un error con FWP_E_INCOMPATIBLE_TXN. Para obtener más información sobre las transacciones, consulta administración de objetos .

Requisitos

Requisito Valor
cliente mínimo admitido Disponible a partir de Windows Vista.
de la plataforma de destino de Universal
encabezado de fwpmk.h
biblioteca de fwpkclnt.lib
irQL <= PASSIVE_LEVEL

Consulte también