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。
-
reserved
-
保留。
-
标志
-
指定一组位标志，用于指定在此端口上建立的连接的性质。 此成员可以是以下标志的组合。
值 含义 - GATEWAY_ACTIVE
如果设置了此标志，则 NetBIOS 网关在服务器上处于活动状态。 - MESSENGER_PRESENT
如果设置了此标志，则信使服务在远程客户端上运行。 - 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 |
| 标头 |
|