RAS_CONNECTION_EX 結構 (mprapi.h)
RAS_CONNECTION_EX結構包含連線的特定資訊，包括：使用者名稱、網域和全域唯一 (識別碼) 相關聯的 GUID、其網路存取保護 (NAP) 隔離狀態、其封包統計資料，以及其點對點 (PPP) 和 Internet Key Exchange 第 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
值，指定在 RFC4555中所定義之連線上發生的 IKEv2 Mobility 和 Multihoming Protocol (MOBIKE) 交換器數目。 dwNumSwitchOvers 只有在 dwConnectionFlags為RAS_FLAGS_IKEV2_CONNECTION時才有效。
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 |