IPSEC_KEY_MANAGER_KEY_DICTATION_CHECK0 callback function (fwpmu.h)

Article
02/22/2024

The IPSEC_KEY_MANAGER_KEY_DICTATION_CHECK0 function indicates whether the Trusted Intermediary Agent (TIA) will dictate the keys for the SA being negotiated.

Syntax

IPSEC_KEY_MANAGER_KEY_DICTATION_CHECK0 IpsecKeyManagerKeyDictationCheck0;

void IpsecKeyManagerKeyDictationCheck0(
  [in]  const IKEEXT_TRAFFIC0 *ikeTraffic,
  [out] BOOL *willDictateKey,
  [out] UINT32 *weight
)
{...}

Parameters

[in] ikeTraffic

Type: IKEEXT_TRAFFIC0*

Specifies the traffic for which keys should be set or retrieved.

[out] willDictateKey

Type: BOOL*

True if the TIA will dictate the keys; otherwise, false.

[out] weight

Type: UINT32*

Specifies the weight that this TIA should be given compared to any peers.

Return value

None

Remarks

Call IPsecKeyManagerAddAndRegister to register this function pointer.

If the TIA wants to dictate the keys, and its weight is higher than that of any peers, IPsec will subsequently call IPSEC_KEY_MANAGER_DICTATE_KEY0.

Requirements

Requirement	Value
Minimum supported client	Windows 8 [desktop apps only]
Minimum supported server	Windows Server 2012 [desktop apps only]
Target Platform	Windows
Header	fwpmu.h