共用方式為

RAS_CONNECTION_4 結構 (mprapi.h)

  • 發行項

包含連線的特定資訊，包括：使用者名稱、網域、全域唯一標識碼 (GUID) 關聯、網路存取保護 (NAP) 隔離狀態、封包統計數據，以及其點對點 (PPP) 和 Internet Key Exchange 第 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 成員必須至少包含下列其中一個值。

值 意義
RAS_FLAGS_PPP_CONNECTION
0x00000001
 聯機使用點對點通訊協定 (PPP) 。
RAS_FLAGS_MESSENGER_PRESENT
0x00000002
 Messenger 服務在用戶端上作用中，而且訊息可以使用 MprAdminSendUserMessage 函式傳送至用戶端。
RAS_FLAGS_QUARANTINE_PRESENT
0x00000008
 線上目前處於隔離狀態。 如需如何從隔離區移除連線的資訊，請參閱 MprAdminConnectionRemoveQuarantine。
RAS_FLAGS_ARAP_CONNECTION
0x00000010
 聯機使用 AppleTalk 遠端存取通訊協定 (ARAP) 。
RAS_FLAGS_IKEV2_CONNECTION
0x00000010
 聯機使用 IKEv2。
RAS_FLAGS_DORMANT
0x00000020
 聯機使用 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時，這個值才有效。

connectionStartTime

FILETIME 結構，指定UTC的連線開始時間。

ullBytesXmited

值，指定在連接上傳輸的位元元組數目。

ullBytesRcved

值，指定連接上收到的位元元組數目。

dwFramesXmited

值，指定在連接上傳輸的框架數目。

dwFramesRcved

值，指定連接上收到的畫面格數目。

dwCrcErr

值，指定連線上的迴圈備援檢查 (CRC) 錯誤數目。

dwTimeoutErr

值，指定連線上的逾時錯誤數目。

dwAlignmentErr

值，指定連接上的對齊錯誤數目。

dwHardwareOverrunErr

值，指定連線上的硬體溢出錯誤數目。

dwFramingErr

值，指定連接上的框架錯誤數目。

dwBufferOverrunErr

值，指定連線上的緩衝區溢出錯誤數目。

dwCompressionRatioIn

值，指定在此連接上接收數據的百分比進行壓縮。 dwCompressionRatioIn 成員是壓縮數據的大小除以處於未壓縮狀態之相同數據的大小。

dwCompressionRatioOut

值，指定在此連接上傳輸之數據的百分比。 比率是壓縮數據的大小，除以處於未壓縮狀態的相同數據大小。

dwNumSwitchOvers

值，指定連線上發生之 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_INFO2結構或IKEV2_PROJECTION_INFO2結構的PROJECTION_INFO2結構。

hConnection

RAS 連線的句柄。

hInterface

RAS 連接介面的句柄。

dwDeviceType

值，指定 VPN 連線的通道類型。 下表顯示這個成員的可能值。

值 意義
RDT_Tunnel_Pptp
 點對點通道 (PPTP)
RDT_Tunnel_L2tp
 L2TP 通道
RDT_Tunnel_Sstp
 SSTP 通道
RDT_Tunnel_IKev2
 IKEv2 通道

規格需求

需求 值
最低支援的用戶端 都不支援
最低支援的伺服器 Windows Server 2012 [僅限傳統型應用程式]
標頭 mprapi.h