структура 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
Заголовок
Rassapi.h

См. также раздел

Обзор службы удаленного доступа (RAS)

Структуры администрирования сервера RAS

RAS_PORT_1

RAS_PORT_STATISTICS

RasAdminGetUserAccountServer

RasAdminPortEnum