структура RAS_PORT_0
[Эта версия структуры RAS_PORT_0 не поддерживается в Windows Vista. Используйте более новую RAS_PORT_0 , определенную в mprapi.h.]
Структура 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, указывающая имя порта, например "COM1".
-
wszDeviceType
-
Строка Юникода со значением NULL, указывающая тип устройства, с которым было установлено подключение, например Модем или ISDN. Список типов устройств, которые могут быть указаны в этом элементе, включает все типы устройств, установленные на сервере, включая устройства сторонних производителей.
-
wszDeviceName
-
Строка Юникода со значением NULL, указывающая имя устройства, с которым было установлено подключение, например "Hayes 9600" или "PCIMACISDN1".
-
wszMediaName
-
Указывает строку Юникода, завершающуюся значением NULL, которая указывает имя носителя, используемого для соединения, например rasser или rastapi.
-
Защищены
-
Зарезервировано.
-
Flags
-
Задает набор битовых флагов, указывающих характер соединения, установленного на этом порту. Этот элемент может быть сочетанием следующих флагов.
Значение Значение - GATEWAY_ACTIVE
Если этот флаг установлен, шлюз NetBIOS активен на сервере. - MESSENGER_PRESENT
Если этот флаг установлен, служба messenger выполняется на удаленном клиенте. - PORT_MULTILINKED
Если этот флаг установлен, порт будет многосвязным с другими портами. Используйте эти сведения для отображения состояния подключения в виде многосвязного порта.
Для многосвязного порта структура RAS_PORT_STATISTICS содержит два набора статистики: один только для порта, а другой — для объединенных портов в многолинейном подключении.- PPP_CLIENT
Если этот флаг установлен, удаленный клиент подключается по протоколу PPP. Если этот флаг не установлен, удаленный клиент подключен по протоколу AMB. - REMOTE_LISTEN
Если этот флаг установлен, параметру RemoteListen шлюза NetBIOS присваивается значение 1 на сервере. - USER_AUTHENTICATED
Если этот флаг установлен, удаленный клиент подключается к серверу, и пользователь прошел проверку подлинности. Проверьте этот флаг, чтобы убедиться, что клиент действительно подключен к порту. Если установлены флаги MESSENGER_PRESENT, GATEWAY_ACTIVE и REMOTE_LISTEN, используйте службу messenger для отправки административного сообщения удаленному клиенту. Если MESSENGER_PRESENT и REMOTE_LISTEN заданы, но GATEWAY_ACTIVE нет, отправляйте сообщения клиенту только с сервера RAS, к которому подключен клиент.
-
wszUserName
-
Строка Юникода со значением NULL, указывающая имя удаленного пользователя, подключенного к этому порту.
-
wszComputer
-
Строка Юникода, заканчивающаяся null, указывающая имя удаленного клиентского компьютера.
-
dwStartSessionTime
-
Указывает время (в секундах) с 1 января 1970 г., когда клиент подключается к серверу RAS на этом порту. Используйте функции стандартного времени для форматирования этого значения для отображения.
-
wszLogonDomain
-
Указывает строку Юникода, завершающуюся значением NULL, которая указывает имя домена, в котором удаленный пользователь прошел проверку подлинности. Эта строка является только доменным именем без префикса "\\".
-
fAdvancedServer
-
Указывает ненулевой флаг, если сервер RAS, связанный с этим портом, является расширенным сервером, например Windows 2000 Advanced Server. Используйте эти сведения для определения имени сервера с базой данных учетной записи пользователя. Если сервер RAS является расширенным сервером, получите имя сервера учетной записи пользователя, сцепля префикс "\\" с именем, возвращенным в члене wszLogonDomain . Это связано с тем, что для расширенного сервера имя локального домена входа совпадает с именем сервера. Если сервер RAS является рабочей станцией, используйте функцию RasAdminGetUserAccountServer , чтобы получить имя сервера учетной записи пользователя.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента |
Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера |
Windows 2000 Server [только классические приложения] |
| Окончание поддержки клиентов |
Windows XP |
| Прекращение поддержки сервера |
Windows Server 2003 |
| Заголовок |
|