RAS_PORT_1 結構
[自 Windows Vista 起，不支援此 版本的RAS_PORT_1 結構。 請改用 mprapi.h 中定義的較新 RAS_PORT_1 。]
RAS_PORT_1結構包含 RAS 埠的相關資訊。
語法
typedef struct _RAS_PORT_1 {
RAS_PORT_0 rasport0;
DWORD LineCondition;
DWORD HardwareCondition;
DWORD LineSpeed;
WORD NumStatistics;
WORD NumMediaParms;
DWORD SizeMediaParms;
RAS_PPP_PROJECTION_RESULT ProjResult;
} RAS_PORT_1, *PRAS_PORT_1;
成員
-
rasport0
-
指定 RAS_PORT_0 結構，其中包含埠的相關資訊，例如埠名稱、連線到埠的遠端使用者名稱等等。
-
LineCondition
-
指定埠的狀態。 這個成員可以是下列其中一個值。
值 意義 - RAS_PORT_NON_OPERATIONAL
埠無法運作。 檢查事件記錄檔中是否有伺服器所報告的錯誤。 - RAS_PORT_DISCONNECTED
埠目前已中斷連線。 - RAS_PORT_CALLING_BACK
RAS 伺服器正在呼叫 RAS 用戶端。 - RAS_PORT_LISTENING
埠正在等候用戶端呼叫 。 - RAS_PORT_AUTHENTICATING
伺服器正在驗證遠端用戶端。 - RAS_PORT_AUTHENTICATED
遠端用戶端現在已驗證。 - RAS_PORT_INITIALIZING
附加至埠的裝置正在初始化。 當初始化完成時，埠的狀態會變更為RAS_PORT_LISTENING。 -
HardwareCondition
-
指定下列其中一個值，指出連接至埠的裝置狀態。
值 意義 - RAS_MODEM_OPERATIONAL
連結至此埠的數據機可運作，且已準備好接收用戶端呼叫。 - RAS_MODEM_HARDWARE_FAILURE
連接到此埠的數據機發生硬體問題。 -
LineSpeed
-
指定電腦可以與埠通訊的速度，以每秒的位數為單位。
-
NumStatistics
-
未使用這個成員。 RAS 管理功能，例如 RasAdminPortGetInfo 函式，會使用 RAS_PORT_STATISTICS 結構來傳回埠統計資料。
-
NumMediaParms
-
指定此埠的媒體特定參數數目。 對於序列媒體，這通常是出現在SERIAL.INI檔案中的值數目。
-
SizeMediaParms
-
指定所有媒體特定參數所需的緩衝區大小，以位元組為單位。 RasAdminPortGetInfo函式會傳回緩衝區，其中包含具有埠媒體參數和值的RAS_PARAMETERS結構陣列。
-
ProjResult
-
RAS_PPP_PROJECTION_RESULT結構，指定此埠的 PPP 投影資訊。 此結構會提供 RAS 用戶端連線到伺服器時交涉之每個通訊協定的資訊。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows 2000 Server [僅限桌面應用程式] |
| 用戶端支援結束 |
Windows XP |
| 伺服器終止支援 |
Windows Server 2003 |
| 標頭 |
|