Compartir a través de

Función IPsecKeyManagerAddAndRegister0 (fwpmu.h)

  • Artículo

La función IPsecKeyManagerAddAndRegister0 registra un Agente intermediario de confianza (TIA) con IPsec.

Sintaxis

DWORD IPsecKeyManagerAddAndRegister0(
  [in]  HANDLE                             engineHandle,
  [in]  const IPSEC_KEY_MANAGER0           *keyManager,
  [in]  const IPSEC_KEY_MANAGER_CALLBACKS0 *keyManagerCallbacks,
  [out] HANDLE                             *keyMgmtHandle
);

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] keyManager

Tipo: const IPSEC_KEY_MANAGER0*

Conjunto de devoluciones de llamada de administración de claves que invocará IPsec.

[in] keyManagerCallbacks

Tipo: const IPSEC_KEY_MANAGER_CALLBACKS0*

Conjunto de devoluciones de llamada que IPsec debe invocar en varias fases de negociación de SA.

[out] keyMgmtHandle

Tipo: HANDLE*

Dirección del registro recién creado.

Valor devuelto

Tipo: DWORD

Código o valor devuelto Descripción
ERROR_SUCCESS
0
 La TIA se registró correctamente.
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.
FWP_E_ALREADY_EXISTS
0x80320009L
 La TIA no se registró correctamente porque ya se ha registrado otra TIA para dictar claves.
FWP_E_INVALID_INTERVAL
0x80320021L
 La TIA no se registró correctamente porque keyDictationTimeoutHint superó el valor máximo permitido de 10 segundos.
SEC_E_CANNOT_INSTALL
0x80090307L
 El TIA no se registró correctamente porque la imagen binaria no ha establecido la propiedad IMAGE_DLLCHARACTERISTICS_FORCE_INTEGRITY .

Comentarios

Si se establece la marca IPSEC_KEY_MANAGER_FLAG_DICTATE_KEY para keyManager, se deben especificar los tres miembros de devolución de llamada de keyManagerCallbacks ; de lo contrario, solo se debe especificar la devolución de llamada keyNotify .

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

Requisitos

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

Consulte también

IPSEC_KEY_MANAGER0

IPSEC_KEY_MANAGER_CALLBACKS0

Funciones de PMA