Сведения о сервере RAS и администрирование портов

Функции администрирования сервера RAS получают сведения о указанном сервере RAS и его портах. Эти функции также используются для завершения подключения на указанном порту сервера RAS.

Функция MprAdminServerGetInfo возвращает структуру MPR_SERVER_0, содержащую сведения о конфигурации сервера RAS. Возвращаемые сведения включают количество портов, доступных для подключений, количество используемых портов и номер версии сервера.

Функция MprAdminPortEnum извлекает массив структур RAS_PORT_0. Каждая структура содержит сведения для одного из портов, настроенных на сервере RAS. Сведения для каждого порта включают:

• Имя порта
• Сведения о устройстве, подключенном к порту
• Указывает, является ли сервер RAS, связанный с портом, сервером Windows NT/Windows 2000
• Указывает, используется ли порт и, если он есть, сведения о подключении

Чтобы получить порты, используемые определенным подключением, передайте MprAdminPortEnum дескриптор этого соединения в параметре hConnection. Чтобы получить дескриптор подключения, используйте функцию MprAdminConnectionEnum. В качестве альтернативы, если вы реализовали библиотеку DLL администрирования RAS, функции MprAdminAcceptNewConnection и MprAdminAcceptNewConnection2 получают дескриптор для каждого нового подключения во время установки подключения.

Вы можете вызвать функцию MprAdminPortGetInfo, чтобы получить дополнительные сведения об указанном порту на сервере RAS. Эта функция возвращает структуру RAS_PORT_1, содержащую структуру RAS_PORT_0и дополнительные сведения о текущем состоянии порта. Функция RasAdminPortGetInfo также возвращает массив структур RAS_PARAMETERS, описывающих значения любых ключей, специфичных для медиа, связанных с портом. Структура RAS_PARAMETERS использует значение из перечисления RAS_PARAMS_FORMAT, чтобы указать формат значения для каждого специфического для носителя ключа.

Функция MprAdminPortGetInfo также возвращает структуру RAS_PORT_STATISTICS, которая содержит различные статистические счетчики для текущего подключения, если таковое имеется, на порту. Для порта, который является частью многолинейного подключения, MprAdminPortGetInfo возвращает статистику для отдельного порта и совокупной статистики для всех портов, участвующих в подключении. Функцию mprAdminPortClearStats можно использовать для сброса счетчиков статистики для порта. Функция MprAdminPortDisconnect отключает используемый порт.

Используйте функцию для освобождения памяти, выделенной функциями mprAdminPortEnum и mprAdminPortGetInfo. Используйте функцию MprAdminGetErrorString, чтобы получить строку, описывающую код ошибки RAS, возвращаемый одной из функций администрирования сервера RAS (RasAdmin).