mprapi.h) (IKEV2_PROJECTION_INFO 结构

IKEV2_PROJECTION_INFO 结构包含 Internet 密钥交换 (IKE) 协商期间获取的信息。

语法

typedef struct _IKEV2_PROJECTION_INFO {
  DWORD   dwIPv4NegotiationError;
  WCHAR   wszAddress[IPADDRESSLEN + 1];
  WCHAR   wszRemoteAddress[IPADDRESSLEN + 1];
  ULONG64 IPv4SubInterfaceIndex;
  DWORD   dwIPv6NegotiationError;
  BYTE    bInterfaceIdentifier[8];
  BYTE    bRemoteInterfaceIdentifier[8];
  BYTE    bPrefix[8];
  DWORD   dwPrefixLength;
  ULONG64 IPv6SubInterfaceIndex;
  DWORD   dwOptions;
  DWORD   dwAuthenticationProtocol;
  DWORD   dwEapTypeId;
  DWORD   dwCompressionAlgorithm;
  DWORD   dwEncryptionMethod;
} IKEV2_PROJECTION_INFO, *PIKEV2_PROJECTION_INFO;

成员

dwIPv4NegotiationError

一个 值，该值指定 IPv4 协商的结果。 值为零表示已成功分配 IPv4 地址。 非零值指示失败，是协商期间发生的致命错误。

wszAddress[IPADDRESSLEN + 1]

包含 Unicode 字符串的数组，该字符串指定本地客户端的 IPv4 地址。 此字符串的格式为“a.b.c.d”。 仅当 dwIPv4NegotiationError 为零时，wszAddress 才有效。

wszRemoteAddress[IPADDRESSLEN + 1]

包含 Unicode 字符串的数组，该字符串指定远程服务器的 IPv4 地址。 此字符串的格式为“a.b.c.d”。 wszRemoteAddress 仅在 dwIPv4NegotiationError 为零时有效。 如果地址不可用，则此成员为空字符串。

IPv4SubInterfaceIndex

一个 值，该值指定与服务器上的连接对应的 IPv4 子接口索引。

dwIPv6NegotiationError

一个 指定 IPv6 协商结果的 值。 值为零表示 IPv6 地址已成功协商。 非零值指示失败，是协商期间发生的致命错误。

bInterfaceIdentifier[8]

一个数组，指定客户端的 64 位 IPv6 接口标识符。 128 位 IPv6 Internet 地址的最后 64 位被视为“接口标识符”，它为前面的 64 位提供了很强的唯一性级别。 bInterfaceIdentifier 仅在 dwIPv6NegotiationError 为零且不得为零时有效。

bRemoteInterfaceIdentifier[8]

一个数组，指定服务器的 64 位 IPv6 接口标识符。 128 位 IPv6 Internet 地址的最后 64 位被视为“接口标识符”，它为前面的 64 位提供了很强的唯一性级别。 bInterfaceIdentifier 仅在 dwIPv6NegotiationError 为零且不得为零时有效。

bPrefix[8]

一个 指定客户端接口 IPv6 地址前缀的 值。

dwPrefixLength

一个 值，该值指定 bPrefix 的长度（以位为单位）。

IPv6SubInterfaceIndex

一个 值，该值指定与服务器上的连接对应的 IPv6 子接口索引。

dwOptions

未使用。

dwAuthenticationProtocol

一个 值，该值指定用于对远程服务器进行身份验证的身份验证协议。 支持以下身份验证协议：

值	含义
MPRAPI_IKEV2_AUTH_USING_CERT	X.509 公钥基础结构证书 (RFC 2459)
MPRAPI_IKEV2_AUTH_USING_EAP	可扩展身份验证协议

dwEapTypeId

一个 值，该值指定用于对本地客户端进行身份验证的可扩展身份验证协议 (EAP) 的类型标识符。 仅当 dwAuthenticationProtocolMPRAPI_IKEV2_AUTH_USING_EAP时，此成员的值才有效。

dwCompressionAlgorithm

未使用。

dwEncryptionMethod

一个 值，该值指定连接中使用的加密方法。 支持以下加密方法：

值	含义
IPSEC_CIPHER_TYPE_3DES	3DES 加密
IPSEC_CIPHER_TYPE_AES_128	AES-128 加密
IPSEC_CIPHER_TYPE_AES_192	AES-192 加密
IPSEC_CIPHER_TYPE_AES_256	AES-256 加密

要求

最低受支持的客户端	无受支持的版本
最低受支持的服务器	Windows Server 2008 R2 [仅限桌面应用]
标头	mprapi.h

另请参阅

路由器管理参考

路由器管理结构