RAS_PORT_0結構
[自 Windows Vista 起，不支援此 版本的RAS_PORT_0 結構。 請改用 mprapi.h 中定義的較新 RAS_PORT_0 。]
RAS_PORT_0結構包含描述 RAS 埠的資訊。
語法
typedef struct _RAS_PORT_0 {
WCHAR wszPortName[RASSAPI_MAX_PORT_NAME];
WCHAR wszDeviceType[RASSAPI_MAX_DEVICETYPE_NAME];
WCHAR wszDeviceName[RASSAPI_MAX_DEVICE_NAME];
WCHAR wszMediaName[RASSAPI_MAX_MEDIA_NAME];
DWORD reserved;
DWORD Flags;
WCHAR wszUserName[UNLEN + 1];
WCHAR wszComputer[NETBIOS_NAME_LEN];
DWORD dwStartSessionTime;
WCHAR wszLogonDomain[DNLEN + 1];
BOOL fAdvancedServer;
} RAS_PORT_0, *PRAS_PORT_0;
成員
-
wszPortName
-
以 Null 結尾的 Unicode 字串，指定埠的名稱，例如 「COM1」。
-
wszDeviceType
-
以 Null 終止的 Unicode 字串，指定建立連線的裝置類型，例如數據機或 ISDN。 此成員中可能指定的裝置類型清單包含伺服器上安裝的所有裝置類型，包括協力廠商裝置。
-
wszDeviceName
-
以 Null 終止的 Unicode 字串，指定建立連線的裝置名稱，例如 「Hayes 9600」 或 「PCIMACISDN1」。
-
wszMediaName
-
指定以 Null 結尾的 Unicode 字串，指定用於連線的媒體名稱，例如 rasser 或 rastapi。
-
保留
-
保留的。
-
旗標
-
指定一組位旗標，指定在此埠上建立的連接本質。 這個成員可以是下列旗標的組合。
值 意義 - GATEWAY_ACTIVE
如果設定此旗標，NetBIOS 閘道就會在伺服器上作用中。 - MESSENGER_PRESENT
如果設定此旗標，Messenger 服務就會在遠端用戶端上執行。 - PORT_MULTILINKED
如果設定此旗標，埠會與其他埠進行多重連結。 使用這項資訊，將線上狀態顯示為多連結埠。
對於多連結埠， RAS_PORT_STATISTICS 結構包含兩組統計資料：一組單獨用於埠，另一組用於多連結連線中的合併埠。- PPP_CLIENT
如果已設定此旗標，則使用 PPP 連線的遠端用戶端。 如果未設定此旗標，則使用 AMB 通訊協定連線的遠端用戶端。 - REMOTE_LISTEN
如果設定此旗標，NetBIOS 閘道的 RemoteListen 參數會在伺服器上設定為 1。 - USER_AUTHENTICATED
如果設定此旗標，遠端用戶端會連線到伺服器，且使用者已經過驗證。 請檢查此旗標，以確保用戶端實際上已連線到埠。 如果已設定MESSENGER_PRESENT、GATEWAY_ACTIVE和REMOTE_LISTEN旗標，請使用 messenger 服務將系統管理訊息傳送至遠端用戶端。 如果已設定MESSENGER_PRESENT和REMOTE_LISTEN，但GATEWAY_ACTIVE不是，則只會從用戶端連線的 RAS 伺服器將訊息傳送至用戶端。
-
wszUserName
-
以 Null 結尾的 Unicode 字串，指定連線到此埠的遠端使用者名稱。
-
wszComputer
-
以 Null 結尾的 Unicode 字串，指定遠端用戶端電腦的名稱。
-
dwStartSessionTime
-
指定從 1970 年 1 月 1 日起，用戶端在此埠上連線到 RAS 伺服器的時間，以秒為單位。 使用標準時間函式來格式化此值以供顯示。
-
wszLogonDomain
-
指定以 Null 結尾的 Unicode 字串，指定遠端使用者驗證所在網域的名稱。 此字串只是功能變數名稱，不含 「\\」 前置詞。
-
fAdvancedServer
-
指定如果與此埠相關聯的 RAS 伺服器是進階伺服器，例如 Windows 2000 進階伺服器，則指定非零的旗標。 使用這項資訊來判斷具有使用者帳戶資料庫的伺服器名稱。 如果 RAS 伺服器是進階伺服器，請將前置詞 「\\」 串連至 wszLogonDomain 成員中傳回的名稱，以取得使用者帳戶伺服器的名稱。 這是因為對於進階伺服器，本機登入功能變數名稱與伺服器名稱相同。 如果 RAS 伺服器是工作站，請使用 RasAdminGetUserAccountServer 函式來取得使用者帳戶伺服器的名稱。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 |
Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 |
Windows 2000 Server [僅限桌面應用程式] |
| 用戶端支援結束 |
Windows XP |
| 伺服器終止支援 |
Windows Server 2003 |
| 標頭 |
|