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
標頭	Rassapi.h

另請參閱

遠端存取服務 (RAS) 概觀

RAS 伺服器系統管理結構

RAS_PARAMETERS

RAS_PORT_0

RAS_PORT_STATISTICS

RAS_PPP_PROJECTION_RESULT

RasAdminAcceptNewConnection

RasAdminConnectionHangupNotification

RasAdminPortGetInfo