RAS_CONNECTION_4 结构 (mprapi.h)
包含连接的特定信息，包括：与连接关联的用户名、域、全局唯一标识符 (GUID) 、网络访问保护 (NAP) 隔离状态、数据包统计信息及其点到点 (PPP) 和 Internet 密钥交换版本 2 (IKEv2) 相关信息。
语法
typedef struct _RAS_CONNECTION_4 {
DWORD dwConnectDuration;
ROUTER_INTERFACE_TYPE dwInterfaceType;
DWORD dwConnectionFlags;
WCHAR wszInterfaceName[MAX_INTERFACE_NAME_LEN + 1];
WCHAR wszUserName[UNLEN + 1];
WCHAR wszLogonDomain[DNLEN + 1];
WCHAR wszRemoteComputer[NETBIOS_NAME_LEN + 1];
GUID guid;
RAS_QUARANTINE_STATE rasQuarState;
FILETIME probationTime;
FILETIME connectionStartTime;
ULONGLONG ullBytesXmited;
ULONGLONG ullBytesRcved;
DWORD dwFramesXmited;
DWORD dwFramesRcved;
DWORD dwCrcErr;
DWORD dwTimeoutErr;
DWORD dwAlignmentErr;
DWORD dwHardwareOverrunErr;
DWORD dwFramingErr;
DWORD dwBufferOverrunErr;
DWORD dwCompressionRatioIn;
DWORD dwCompressionRatioOut;
DWORD dwNumSwitchOvers;
WCHAR wszRemoteEndpointAddress[MAXIPADRESSLEN + 1];
WCHAR wszLocalEndpointAddress[MAXIPADRESSLEN + 1];
PROJECTION_INFO2 ProjectionInfo;
HANDLE hConnection;
HANDLE hInterface;
DWORD dwDeviceType;
} RAS_CONNECTION_4, *PRAS_CONNECTION_4;
成员
dwConnectDuration
一个 值，该值表示连接持续时间（以秒为单位）。
dwInterfaceType
标识连接接口类型的 ROUTER_INTERFACE_TYPE 枚举。
dwConnectionFlags
指定连接属性的标志的位图。 dwConnectionFlags 成员必须至少包含以下值之一。
| 值 | 含义 |
|---|---|
|
连接使用点到点协议 (PPP) 。 |
|
信使服务在客户端上处于活动状态，可以使用 MprAdminSendUserMessage 函数将消息发送到客户端。 |
|
连接当前处于隔离状态。 有关如何从隔离区中删除连接的信息，请参阅 MprAdminConnectionRemoveQuarantine。 |
|
连接使用 AppleTalk 远程访问协议 (ARAP) 。 |
|
连接使用 IKEv2。 |
|
连接使用 IKEv2，服务器不可访问。 |
wszInterfaceName[MAX_INTERFACE_NAME_LEN + 1]
一个以 null 结尾的 Unicode 字符串，包含此连接的接口的名称。
wszUserName[UNLEN + 1]
一个以 null 结尾的 Unicode 字符串，包含登录到连接的用户的名称。
wszLogonDomain[DNLEN + 1]
一个以 null 结尾的 Unicode 字符串，该字符串包含对其连接的用户进行身份验证的域。
wszRemoteComputer[NETBIOS_NAME_LEN + 1]
一个以 null 结尾的 Unicode 字符串，其中包含远程计算机的名称。
guid
标识连接的 GUID。 对于传入连接，只要连接处于活动状态，此 GUID 才有效。
rasQuarState
一个RAS_QUARANTINE_STATE结构，用于指定连接的 NAP 隔离状态。
probationTime
FILETIME 结构，指定连接退出隔离所需的时间，之后将删除连接。 仅当 rasQuarState 成员的值为 RAS_QUAR_STATE_PROBATION 时，此值才有效。
connectionStartTime
一个 FILETIME 结构，它以 UTC 为单位指定连接开始时间。
ullBytesXmited
一个 值，该值指定在连接上传输的字节数。
ullBytesRcved
一个 值，该值指定在连接上收到的字节数。
dwFramesXmited
一个 值，该值指定在连接上传输的帧数。
dwFramesRcved
一个 值，该值指定在连接上收到的帧数。
dwCrcErr
一个 值，该值指定连接的循环冗余检查 (CRC) 错误的数目。
dwTimeoutErr
一个 值，该值指定连接上的超时错误数。
dwAlignmentErr
一个 值，该值指定连接上的对齐错误数。
dwHardwareOverrunErr
一个 值，该值指定连接上的硬件溢出错误数。
dwFramingErr
一个 值，该值指定连接上的成帧错误数。
dwBufferOverrunErr
一个 值，该值指定连接上的缓冲区溢出错误数。
dwCompressionRatioIn
一个 值，该值指定在此连接上收到的数据的压缩百分比。 dwCompressionRatioIn 成员是压缩数据的大小除以处于未压缩状态的相同数据的大小。
dwCompressionRatioOut
一个 值，该值指定在此连接上传输的数据被压缩的百分比。 该比率是压缩数据的大小除以处于未压缩状态的相同数据的大小。
dwNumSwitchOvers
一个 值，该值指定连接上发生的 IKEv2 移动性和多宿主协议 (MOBIKE) 交换机的数目。 仅当 dwConnectionFlags 成员RAS_FLAGS_IKEV2_CONNECTION时，dwNumSwitchOvers 成员才有效。
wszRemoteEndpointAddress[MAXIPADRESSLEN + 1]
一个以 null 结尾的 Unicode 字符串，其中包含连接中远程计算机的 IP 地址。 此字符串的格式为“a.b.c.d”。
wszLocalEndpointAddress[MAXIPADRESSLEN + 1]
一个以 null 结尾的 Unicode 字符串，其中包含连接中本地计算机的 IP 地址。 此字符串的格式为“a.b.c.d”。
ProjectionInfo
包含 PPP_PROJECTION_INFO2 结构或 IKEV2_PROJECTION_INFO2 结构的 PROJECTION_INFO2 结构。
hConnection
RAS 连接的句柄。
hInterface
RAS 连接接口的句柄。
dwDeviceType
一个 值，该值指定 VPN 连接的隧道类型。 下表显示了此成员的可能值。
| 值 | 含义 |
|---|---|
|
点到点隧道 (PPTP) |
|
L2TP 隧道 |
|
SSTP 隧道 |
|
IKEv2 隧道 |
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 无受支持的版本 |
| 最低受支持的服务器 | Windows Server 2012 [仅限桌面应用] |
| 标头 | mprapi.h |