Funzione IPsecKeyManagerAddAndRegister0 (fwpmu.h)

Articolo
02/28/2024

La funzione IPsecKeyManagerAddAndRegister0 registra un agente intermedio attendibile (TIA) con IPsec.

Sintassi

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

Parametri

[in] engineHandle

Tipo: HANDLE

Handle per una sessione aperta al motore di filtro. Chiamare FwpmEngineOpen0 per aprire una sessione al motore di filtro.

[in] keyManager

Tipo: const IPSEC_KEY_MANAGER0*

Set di callback di gestione delle chiavi che IPsec richiamerà.

[in] keyManagerCallbacks

Tipo: const IPSEC_KEY_MANAGER_CALLBACKS0*

Set di callback che devono essere richiamati da IPsec in varie fasi della negoziazione SA.

[out] keyMgmtHandle

Tipo: HANDLE*

Indirizzo della registrazione appena creata.

Valore restituito

Tipo: DWORD

Codice/valore restituito	Descrizione
ERROR_SUCCESS 0	Il tiA è stato registrato correttamente.
*FWP_E_ codice di errore** 0x80320001: 0x80320039	Errore specifico di Windows Filtering Platform (WFP). Per informazioni dettagliate, vedere Codici di errore del WFP .
*RPC_ codice di errore** 0x80010001: 0x80010122	Errore di comunicazione con il motore firewall remoto o locale.
FWP_E_ALREADY_EXISTS 0x80320009L	Il TIA non è stato registrato correttamente perché un altro TIA è già stato registrato per dettare le chiavi.
FWP_E_INVALID_INTERVAL 0x80320021L	L'interfaccia tiA non è stata registrata correttamente perché keyDictationTimeoutHint ha superato il valore massimo consentito di 10 secondi.
SEC_E_CANNOT_INSTALL 0x80090307L	L'interfaccia tiA non è stata registrata correttamente perché l'immagine binaria non ha impostato la proprietà IMAGE_DLLCHARACTERISTICS_FORCE_INTEGRITY .

Commenti

Se il flag IPSEC_KEY_MANAGER_FLAG_DICTATE_KEY è impostato per keyManager, è necessario specificare tutti e tre i membri di callback di keyManagerCallbacks; in caso contrario, deve essere specificato solo il callback keyNotify

Questa funzione non può essere chiamata dall'interno di una transazione. Avrà esito negativo con FWP_E_TXN_IN_PROGRESS. Per altre informazioni sulle transazioni, vedere Gestione oggetti.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	fwpmu.h
Libreria	Fwpuclnt.lib
DLL	Fwpuclnt.dll

Vedi anche

IPSEC_KEY_MANAGER0

IPSEC_KEY_MANAGER_CALLBACKS0

Funzioni WFP

Condividi tramite