PPP_PROJECTION_INFO2 结构 (mprapi.h)

项目
08/24/2023

包含针对安全套接字隧道协议 ( (SSTP) 、点到点隧道协议 (PPTP) 的点到点 PPP) 协商期间获取的信息，以及第 2 层隧道协议 (L2TP) 。

语法

typedef struct _PPP_PROJECTION_INFO2 {
  DWORD   dwIPv4NegotiationError;
  WCHAR   wszAddress[IPADDRESSLEN + 1];
  WCHAR   wszRemoteAddress[IPADDRESSLEN + 1];
  DWORD   dwIPv4Options;
  DWORD   dwIPv4RemoteOptions;
  ULONG64 IPv4SubInterfaceIndex;
  DWORD   dwIPv6NegotiationError;
  BYTE    bInterfaceIdentifier[8];
  BYTE    bRemoteInterfaceIdentifier[8];
  BYTE    bPrefix[8];
  DWORD   dwPrefixLength;
  ULONG64 IPv6SubInterfaceIndex;
  DWORD   dwLcpError;
  DWORD   dwAuthenticationProtocol;
  DWORD   dwAuthenticationData;
  DWORD   dwRemoteAuthenticationProtocol;
  DWORD   dwRemoteAuthenticationData;
  DWORD   dwLcpTerminateReason;
  DWORD   dwLcpRemoteTerminateReason;
  DWORD   dwLcpOptions;
  DWORD   dwLcpRemoteOptions;
  DWORD   dwEapTypeId;
  DWORD   dwEmbeddedEAPTypeId;
  DWORD   dwRemoteEapTypeId;
  DWORD   dwCcpError;
  DWORD   dwCompressionAlgorithm;
  DWORD   dwCcpOptions;
  DWORD   dwRemoteCompressionAlgorithm;
  DWORD   dwCcpRemoteOptions;
} PPP_PROJECTION_INFO2, *PPPP_PROJECTION_INFO2;

成员

dwIPv4NegotiationError

一个值，该值指定 PPP IPv4 网络控制协议协商的结果。值为 0 表示已成功协商 IPv4。非零值表示失败，还表示在控制协议协商期间发生的致命错误。

wszAddress[IPADDRESSLEN + 1]

一个以 null 结尾的 Unicode 字符串，指定本地客户端的 IPv4 地址。此字符串的格式为“a.b.c.d”。仅当 dwIPv4NegotiationError 为 0 时 ，wszAddress 成员才有效。

wszRemoteAddress[IPADDRESSLEN + 1]

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

dwIPv4Options

一个值，该值指定本地客户端的 IPCP 选项。

值	含义
PPP_IPCP_VJ	指示使用 Van Jacobson 压缩压缩本地客户端发送的 IP 数据报。

dwIPv4RemoteOptions

一个值，该值指定远程服务器的 IPCP 选项。

值	含义
PPP_IPCP_VJ	指示远程服务器发送的 IP 数据报 (即本地计算机接收) 使用 Van Jacobson 压缩进行压缩。

IPv4SubInterfaceIndex

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

dwIPv6NegotiationError

一个值，该值指定 PPP IPv6 网络控制协议协商的结果。值为零表示已成功协商 Ipv6。非零值表示失败，是控制协议协商期间发生的严重错误。

bInterfaceIdentifier[8]

一个数组，指定客户端的 64 位 IPv6 接口标识符。 128 位 IPv6 Internet 地址的最后 64 位被视为接口标识符，这为前面的 64 位提供了很强的唯一性级别。 bInterfaceIdentifier 成员不能为 0，并且仅当 dwIPv6NegotiationError 成员为 0 时有效。

bRemoteInterfaceIdentifier[8]

一个数组，指定服务器的 64 位 IPv6 接口标识符。 128 位 IPv6 Internet 地址的最后 64 位被视为接口标识符，这为前面的 64 位提供了很强的唯一性级别。 bInterfaceIdentifier 成员不能为 0，并且仅当 dwIPv6NegotiationError 成员为 0 时有效。

bPrefix[8]

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

dwPrefixLength

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

IPv6SubInterfaceIndex

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

dwLcpError

一个值，该值指定 PPP LCP 协商的结果。值为零表示已成功协商 LCP。非零值表示失败，表示在控制协议协商期间发生的严重错误。

dwAuthenticationProtocol

一个值，该值指定用于对本地客户端进行身份验证的身份验证协议。此成员可以是以下值之一。

值	含义
PPP_LCP_PAP	密码身份验证协议
PPP_LCP_CHAP	质询握手身份验证协议
PPP_LCP_EAP	可扩展身份验证协议

dwAuthenticationData

一个值，该值指定由 dwAuthenticationProtocol 成员指定的身份验证协议的其他信息。此成员可以是以下值之一。

值	含义
PPP_LCP_CHAP_MD5	MD5 CHAP
PPP_LCP_CHAP_MS	Microsoft CHAP
PPP_LCP_CHAP_MSV2	Microsoft CHAP 版本 2

dwRemoteAuthenticationProtocol

一个值，该值指定用于对远程服务器进行身份验证的身份验证协议。当请求拨号在客户端和服务器上使用不同的身份验证协议时， dwAuthenticationProtocol 成员和 dwRemoteAuthenticationProtocol 成员将有所不同。此成员可以是以下值之一。

值	含义
PPP_LCP_PAP	密码身份验证协议
PPP_LCP_CHAP	质询握手身份验证协议
PPP_LCP_EAP	可扩展身份验证协议

dwRemoteAuthenticationData

一个值，该值指定由 dwRemoteAuthenticationProtocol 成员指定的身份验证协议的其他信息。当请求拨号在客户端和服务器上使用不同的身份验证协议时， dwAuthenticationData 成员和 dwRemoteAuthenticationData 成员将有所不同。此成员可以是以下值之一。

值	含义
PPP_LCP_CHAP_MD5	MD5 CHAP
PPP_LCP_CHAP_MS	Microsoft CHAP
PPP_LCP_CHAP_MSV2	Microsoft CHAP 版本 2

dwLcpTerminateReason

未实现。必须为 0。

dwLcpRemoteTerminateReason

未实现。必须为 0。

dwLcpOptions

一个值，该值指定有关本地客户端正在使用的 LCP 选项的信息。此成员是以下标志的组合。

值	含义
PPP_LCP_MULTILINK_FRAMING	连接使用多链接。
PPP_LCP_PFC	连接使用协议字段压缩。
PPP_LCP_ACFC	连接使用地址和控制字段压缩。
PPP_LCP_SSHF	连接使用短序列号标头格式。
PPP_LCP_DES_56	连接使用 DES 56 位加密。
PPP_LCP_3_DES	连接使用三重 DES 加密。
PPP_LCP_AES_128	连接使用 128 位 AES 加密。
PPP_LCP_AES_256	连接使用 256 位 AES 加密。

dwLcpRemoteOptions

一个值，该值指定远程服务器正在使用的 LCP 选项的相关信息。此成员是以下标志的组合。

值	含义
PPP_LCP_MULTILINK_FRAMING	连接使用多链接。
PPP_LCP_PFC	连接使用协议字段压缩。
PPP_LCP_ACFC	连接使用地址和控制字段压缩。
PPP_LCP_SSHF	连接使用短序列号标头格式。
PPP_LCP_DES_56	连接使用 DES 56 位加密。
PPP_LCP_3_DES	连接使用三重 DES 加密。
PPP_LCP_AES_128	连接使用 128 位 AES 加密。
PPP_LCP_AES_256	连接使用 256 位 AES 加密。

dwEapTypeId

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

dwEmbeddedEAPTypeId

一个值，该值指定 EAP 身份验证中使用的内部 EAP 方法的类型标识符。仅当 dwEapTypeId 成员设置为 IANA-EAP 中定义的 PEAP 时，此成员的值才有效。

dwRemoteEapTypeId

一个值，该值指定用于对远程服务器进行身份验证的可扩展身份验证协议 (EAP) 的类型标识符。仅当 dwRemoteAuthenticationProtocol 成员 PPP_LCP_EAP时，此成员的值才有效。

dwCcpError

一个值，该值指定 PPP CCP 协商的结果。值为 0 表示已成功协商 CCP。非零值指示失败，表示控制协议协商期间发生的致命错误。

dwCompressionAlgorithm

一个值，该值指定本地客户端使用的压缩算法。下表显示了此成员的可能值。

值	含义
RASCCPCA_MPPC	Microsoft 点到点压缩 (MPPC) 协议。
RASCCPCA_STAC	STAC 选项 4。

dwCcpOptions

一个值，该值指定本地客户端上可用的压缩类型。支持以下类型。

值	含义
PPP_CCP_COMPRESSION	不加密的压缩。
PPP_CCP_HISTORYLESS	Microsoft 点到点加密 (MPPE) 处于无状态模式。会话密钥在每次数据包后都会更改。此模式可提高高延迟网络或遇到重大数据包丢失的网络的性能。
PPP_CCP_ENCRYPTION40BITOLD	使用 40 位密钥的 MPPE 压缩。
PPP_CCP_ENCRYPTION40BIT	使用 40 位密钥的 MPPE 压缩。
PPP_CCP_ENCRYPTION56BIT	使用 56 位密钥的 MPPE 压缩。
PPP_CCP_ENCRYPTION128BIT	使用 128 位密钥的 MPPE 压缩。

当通过第 2 层隧道协议 (L2TP) 建立连接并且连接使用 IPSec 加密时，将使用最后三个选项。

dwRemoteCompressionAlgorithm

一个值，该值指定远程服务器使用的压缩算法。支持以下算法。

值	含义
RASCCPCA_MPPC	Microsoft 点到点压缩 (MPPC) 协议。
RASCCPCA_STAC	STAC 选项 4。

dwCcpRemoteOptions

一个值，该值指定远程服务器上可用的压缩类型。支持以下类型。

值	含义
PPP_CCP_COMPRESSION	不加密的压缩。
PPP_CCP_HISTORYLESS	Microsoft 点到点加密 (MPPE) 处于无状态模式。会话密钥在每次数据包后都会更改。此模式可提高高延迟网络或遇到重大数据包丢失的网络的性能。
PPP_CCP_ENCRYPTION40BITOLD	使用 40 位密钥的 MPPE 压缩。
PPP_CCP_ENCRYPTION40BIT	使用 40 位密钥的 MPPE 压缩。
PPP_CCP_ENCRYPTION56BIT	使用 56 位密钥的 MPPE 压缩。
PPP_CCP_ENCRYPTION128BIT	使用 128 位密钥的 MPPE 压缩。
ERROR_PPP_NOT_CONVERGING	远程计算机和 RRAS 无法聚合地址协商。

当通过第 2 层隧道协议 (L2TP) 建立连接并且连接使用 IPSec 加密时，将使用最后三个选项。

要求


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

通过

PPP_PROJECTION_INFO2 结构 (mprapi.h)

语法

成员

要求

反馈

其他资源