[This is preliminary documentation and subject to change.]
The RAS_PORT_0 structure contains information that describes a RAS port.
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;
Value | Meaning |
---|---|
GATEWAY_ACTIVE | If this flag is set, the NetBIOS gateway is active on the server. |
MESSENGER_PRESENT | If this flag is set, the Windows NT messenger service is running on the remote client. |
PORT_MULTILINKED | If this flag is set, the port is multilinked with other ports. You can use this information for displaying the connection status as a multilinked port. For a multilinked port, the RAS_PORT_STATISTICS structure contains two sets of statistics: one for the port alone, and another for the combined ports in the multilink connection. |
PPP_CLIENT | If this flag is set, the remote client connected using PPP. If this flag is not set, the remote client connected using the AMB protocol. |
REMOTE_LISTEN | If this flag is set, the RemoteListen parameter of the NetBIOS gateway is set to 1 on the server. |
USER_AUTHENTICATED | If this flag is set, a remote client is connected to the server and the user has been authenticated. You can check this flag to ensure that a client is actually connected to a port. |
If the MESSENGER_PRESENT, GATEWAY_ACTIVE, and REMOTE_LISTEN flags are set, you can use the Windows NT messenger service to send an administrative message to the remote client. If MESSENGER_PRESENT and REMOTE_LISTEN are set, but GATEWAY_ACTIVE is not, you can send a message to the client only if you send the message from the RAS server the client is dialed in to.
If the MESSENGER_PRESENT, GATEWAY_ACTIVE, and REMOTE_LISTEN flags are set, you can use the Windows NT messenger service to send an administrative message to the remote client. If MESSENGER_PRESENT and REMOTE_LISTEN are set, but GATEWAY_ACTIVE is not, you can send a message to the client only if you send the message from the RAS server the client is dialed in to.
Windows NT: Requires version 4.0 or later.
Windows: Unsupported.
Windows CE: Unsupported.
Header: Declared in rassapi.h.
Remote Access Service Overview, RAS Server Administration Union, RAS_PORT_1, RAS_PORT_STATISTICS, RasAdminGetUserAccountServer, RasAdminPortEnum