Edit

FWPM_NET_EVENT_IKEEXT_MM_FAILURE1 structure (fwpmtypes.h)

  • Article

The FWPM_NET_EVENT_IKEEXT_MM_FAILURE1 structure contains information that describes an IKE/AuthIP Main Mode (MM) failure. FWPM_NET_EVENT_IKEEXT_MM_FAILURE0 is available.

Syntax

typedef struct FWPM_NET_EVENT_IKEEXT_MM_FAILURE1_ {
  UINT32                            failureErrorCode;
  IPSEC_FAILURE_POINT               failurePoint;
  UINT32                            flags;
  IKEEXT_KEY_MODULE_TYPE            keyingModuleType;
  IKEEXT_MM_SA_STATE                mmState;
  IKEEXT_SA_ROLE                    saRole;
  IKEEXT_AUTHENTICATION_METHOD_TYPE mmAuthMethod;
  UINT8                             endCertHash[20];
  UINT64                            mmId;
  UINT64                            mmFilterId;
  wchar_t                           *localPrincipalNameForAuth;
  wchar_t                           *remotePrincipalNameForAuth;
  UINT32                            numLocalPrincipalGroupSids;
  LPWSTR                            *localPrincipalGroupSids;
  UINT32                            numRemotePrincipalGroupSids;
  LPWSTR                            *remotePrincipalGroupSids;
} FWPM_NET_EVENT_IKEEXT_MM_FAILURE1;

Members

failureErrorCode

Windows error code for the failure.

failurePoint

An IPSEC_FAILURE_POINT value that indicates the IPsec state when the failure occurred.

flags

Flags for the failure event.

Value Meaning
FWPM_NET_EVENT_IKEEXT_MM_FAILURE_FLAG_BENIGN Indicates that the failure was benign or expected.
FWPM_NET_EVENT_IKEEXT_MM_FAILURE_FLAG_MULTIPLE Indicates that multiple failure events have been reported.

keyingModuleType

An IKEEXT_KEY_MODULE_TYPE value that specifies the type of keying module.

mmState

An IKEEXT_MM_SA_STATE value that indicates the Main Mode state when the failure occurred.

saRole

An IKEEXT_SA_ROLE value that specifies the security association (SA) role when the failure occurred.

mmAuthMethod

An IKEEXT_AUTHENTICATION_METHOD_TYPE value that specifies the authentication method.

endCertHash[20]

SHA thumbprint hash of the end certificate corresponding to the failures that happen during building or validating certificate chains.

IKEEXT_CERT_HASH_LEN maps to 20.

mmId

LUID for the MM SA.

mmFilterId

Main mode filter ID.

localPrincipalNameForAuth

Name of the MM local security principal.

remotePrincipalNameForAuth

Name of the MM remote security principal.

numLocalPrincipalGroupSids

Number of groups in the local security principal's token.

localPrincipalGroupSids

Groups in the local security principal's token.

numRemotePrincipalGroupSids

Number of groups in the remote security principal's token.

remotePrincipalGroupSids

Groups in the remote security principal's token.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Header fwpmtypes.h

See also

Windows Filtering Platform API Structures