Función FwpmIPsecTunnelAdd0 (fwpmu.h)

  • Artículo

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

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

Sintaxis

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

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.

[in, optional] mainModePolicy

Tipo: FWPM_PROVIDER_CONTEXT0*

Directiva de modo principal para el túnel IPsec.

[in] tunnelPolicy

Tipo: FWPM_PROVIDER_CONTEXT0*

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: FWPM_FILTER_CONDITION0*

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

[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

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [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_CONTEXT0