Función IPsecKeyManagerAddAndRegister0 (fwpmu.h)
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 |
---|---|
|
La TIA se registró correctamente. |
|
Error específico de la Plataforma de filtrado de Windows (PMA). Consulte Códigos de error de PMA para obtener más información. |
|
Error al comunicarse con el motor de firewall remoto o local. |
|
La TIA no se registró correctamente porque ya se ha registrado otra TIA para dictar claves. |
|
La TIA no se registró correctamente porque keyDictationTimeoutHint superó el valor máximo permitido de 10 segundos. |
|
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
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de