Функция RasAdminPortGetInfo

Статья
06/13/2023

[Эта функция предоставляется только для обеспечения обратной совместимости с Windows NT Server 4.0. Он возвращает ERROR_CALL_NOT_IMPLEMENTED в Windows Server 2003. Приложения должны использовать функцию MprAdminPortGetInfo .]

Функция RasAdminPortGetInfo извлекает сведения об указанном порту на указанном сервере.

Синтаксис

DWORD RasAdminPortGetInfo(
  _In_  const WCHAR               *lpszServer,
  _In_  const WCHAR               *lpszPort,
  _Out_       RAS_PORT_1          *pRasPort1,
  _Out_       RAS_PORT_STATISTICS *pRasStats,
  _Out_       RAS_PARAMETERS      **ppRasParams
);

Параметры

lpszServer [in]: Указатель на строку Юникода с пустым завершением, указывающую имя сервера RAS. Укажите имя с символами "\\" в формате \\servername.
lpszPort [in]: Указатель на строку Юникода, завершающуюся null, которая указывает имя порта на сервере.
pRasPort1 [out]: Указатель на структуру RAS_PORT_1 , которую функция заполняет сведениями о состоянии порта.
pRasStats [out]: Указатель на структуру RAS_PORT_STATISTICS , которую функция заполняет статистикой о порте.
ppRasParams [out]: Указатель на переменную указателя, которая получает адрес массива RAS_PARAMETERS структур. Каждая структура содержит имя ключа носителя, например MAXCONNECTBPS, и связанное с ним значение. После завершения работы приложения с этой памятью освободите его, вызвав функцию RasAdminFreeBuffer .

Возвращаемое значение

Если функция выполнена успешно, возвращаемое значение будет ERROR_SUCCESS.

Если функция завершается ошибкой, возвращаемое значение может быть одним из следующих кодов ошибок.

Значение	Значение
ERROR_DEV_NOT_EXIST	Указанный порт недопустим.
ERROR_NOT_ENOUGH_MEMORY	Недостаточно памяти для выделения буфера для массива ppRasParams .

Для этой функции нет расширенных сведений об ошибке; не вызывать GetLastError.

Требования

Требование	Значение
Окончание поддержки клиентов	Windows 2000 Professional
Прекращение поддержки сервера	Windows 2000 Server
Заголовок	Rassapi.h
Библиотека	Rassapi.lib
DLL	Rassapi.dll

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

Обзор службы удаленного доступа (RAS)
Функции администрирования сервера RAS
RAS_PARAMETERS
RAS_PORT_1
RAS_PORT_STATISTICS
RasAdminFreeBuffer