структура RAS_PORT_1

Статья
06/13/2023

[Эта версия структуры RAS_PORT_1 не поддерживается в Windows Vista. Используйте более новую RAS_PORT_1 , определенную в mprapi.h.]

Структура RAS_PORT_1 содержит сведения о порте RAS.

Синтаксис

typedef struct _RAS_PORT_1 {
  RAS_PORT_0                rasport0;
  DWORD                     LineCondition;
  DWORD                     HardwareCondition;
  DWORD                     LineSpeed;
  WORD                      NumStatistics;
  WORD                      NumMediaParms;
  DWORD                     SizeMediaParms;
  RAS_PPP_PROJECTION_RESULT ProjResult;
} RAS_PORT_1, *PRAS_PORT_1;

Члены

rasport0

Задает структуру RAS_PORT_0 , содержащую сведения о порту, например имя порта, имя удаленного пользователя, подключенного к порту, и т. д.

LineCondition

Указывает состояние порта. Этот элемент может быть одним из следующих значений.

Значение	Значение
RAS_PORT_NON_OPERATIONAL	Порт не работает. Проверьте журнал событий на наличие ошибок, сообщенных сервером.
RAS_PORT_DISCONNECTED	В настоящее время порт отключен.
RAS_PORT_CALLING_BACK	Сервер RAS вызывает клиент RAS.
RAS_PORT_LISTENING	Порт ожидает вызова клиента.
RAS_PORT_AUTHENTICATING	Сервер находится в процессе проверки подлинности удаленного клиента.
RAS_PORT_AUTHENTICATED	Удаленный клиент теперь проходит проверку подлинности.
RAS_PORT_INITIALIZING	Устройство, подключенное к порту, инициализируется. После завершения инициализации состояние порта изменится на RAS_PORT_LISTENING.

HardwareCondition

Указывает одно из следующих значений для указания состояния устройства, подключенного к порту.

Значение	Значение
RAS_MODEM_OPERATIONAL	Модем, подключенный к этому порту, работает и готов принимать вызовы клиентов.
RAS_MODEM_HARDWARE_FAILURE	Модем, подключенный к этому порту, имеет проблемы с оборудованием.

LineSpeed

Указывает скорость (в битах в секунду), с которой компьютер может обмениваться данными с портом.

NumStatistics

Этот элемент не используется. Функции администрирования RAS, такие как функция RasAdminPortGetInfo , используют структуру RAS_PORT_STATISTICS для возврата статистики портов.

NumMediaParms

Указывает количество параметров носителя для этого порта. Для последовательного носителя обычно это количество значений, отображаемых в файле SERIAL.INI.

SizeMediaParms

Указывает размер (в байтах) буфера, необходимого для всех параметров носителя. Функция RasAdminPortGetInfo возвращает буфер, содержащий массив RAS_PARAMETERS структур с параметрами мультимедиа и значениями для порта.

ProjResult

Структура RAS_PPP_PROJECTION_RESULT , указывающая сведения о проекции PPP для этого порта. Эта структура предоставляет сведения для каждого протокола, который согласовывается при подключении клиента RAS к серверу.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Окончание поддержки клиентов	Windows XP
Прекращение поддержки сервера	Windows Server 2003
Заголовок	Rassapi.h

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

Обзор службы удаленного доступа (RAS)
Структуры администрирования сервера RAS
RAS_PARAMETERS
RAS_PORT_0
RAS_PORT_STATISTICS
RAS_PPP_PROJECTION_RESULT
RasAdminAcceptNewConnection
RasAdminConnectionHangupNotification
RasAdminPortGetInfo