mprapi.h) (RAS_CONNECTION_EX 结构
RAS_CONNECTION_EX结构包含连接的特定信息，其中包括：与连接关联的用户名、域和全局唯一标识符 (GUID) 、其网络访问保护 (NAP) 隔离状态、其数据包统计信息，以及其点到点 (PPP) 和 Internet 密钥交换版本 2 (IKEv2) 相关信息。
RAS_CONNECTION_EX 结构包含与RAS_CONNECTION_0、RAS_CONNECTION_1、RAS_CONNECTION_2和RAS_CONNECTION_3组合结构相同的大部分信息。
语法
typedef struct _RAS_CONNECTION_EX {
MPRAPI_OBJECT_HEADER Header;
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;
DWORD dwBytesXmited;
DWORD dwBytesRcved;
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_INFO ProjectionInfo;
HANDLE hConnection;
HANDLE hInterface;
} RAS_CONNECTION_EX, *PRAS_CONNECTION_EX;
成员
Header
指定 RAS_CONNECTION_EX 结构的版本的 MPRAPI_OBJECT_HEADER 结构。
dwConnectDuration
一个 值，该值表示连接持续时间（以秒为单位）。
dwInterfaceType
标识连接接口类型的 ROUTER_INTERFACE_TYPE 枚举。
dwConnectionFlags
指定连接属性的标志的位图。 dwConnectionFlags 必须至少包含以下值之一：
| 值 | 含义 |
|---|---|
|
连接使用点到点协议 (PPP) 。 |
|
Messenger 服务在客户端上处于活动状态，可以使用 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
指定连接的 NAP 隔离状态 的RAS_QUARANTINE_STATE 结构。
probationTime
FILETIME 结构，指定连接退出隔离区所需的时间，之后将删除连接。 仅当 rasQuarState 的值为 RAS_QUAR_STATE_PROBATION 时，此值才有效。
dwBytesXmited
一个 值，该值指定在连接上传输的字节数。
dwBytesRcved
一个 值，该值指定在连接上收到的字节数。
dwFramesXmited
一个 值，该值指定在连接上传输的帧数。
dwFramesRcved
一个 值，该值指定在连接上收到的帧数。
dwCrcErr
一个 值，该值指定连接上的循环冗余检查 (CRC) 错误数。
dwTimeoutErr
一个 值，该值指定连接上的超时错误数。
dwAlignmentErr
一个 值，该值指定连接上的对齐错误数。
dwHardwareOverrunErr
一个 值，该值指定连接上的硬件溢出错误数。
dwFramingErr
一个 值，该值指定连接上的帧错误数。
dwBufferOverrunErr
一个 值，该值指定连接上的缓冲区溢出错误数。
dwCompressionRatioIn
一个 值，该值指定在此连接上收到的数据的压缩百分比。 dwCompressionRatioIn 是压缩数据的大小除以处于未压缩状态的相同数据的大小。
dwCompressionRatioOut
一个 值，该值指定压缩此连接上传输的数据所依据的百分比。 该比率是压缩数据的大小除以处于未压缩状态的相同数据的大小。
dwNumSwitchOvers
一个 值，指定连接上发生的 IKEv2 移动性和多宿主协议 (MOBIKE) 交换机的数目 ，如 RFC4555 中定义。 仅当 dwConnectionFlagsRAS_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_INFO 或 IKEV2_PROJECTION_INFO 结构的 PROJECTION_INFO 结构。
hConnection
RAS 连接的句柄。
hInterface
RAS 连接接口的句柄。
要求
| 最低受支持的客户端 | Windows 7 [仅限桌面应用] |
| 最低受支持的服务器 | Windows Server 2008 R2 [仅限桌面应用] |
| 标头 | mprapi.h |