Функция RasAdminPortEnum

Статья
06/13/2023

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

Функция RasAdminPortEnum перечисляет все порты на указанном сервере RAS. Для каждого порта на сервере функция возвращает структуру RAS_PORT_0 , содержащую сведения о порте.

Синтаксис

DWORD RasAdminPortEnum(
  _In_  const WCHAR       *lpszServer,
  _Out_       PRAS_PORT_0 *ppRasPort0,
  _Out_       WORD        *pcEntriesRead
);

Параметры

lpszServer [in]: Указатель на строку Юникода, завершающуюся null, которая указывает имя сервера RAS. Укажите имя с символами "\\" в начале в формате \\имя_сервера.
ppRasPort0 [out]: Указатель на переменную, получающую указатель на буфер, содержащий массив RAS_PORT_0 структур. Когда приложение завершит работу с памятью, освободите ее, вызвав функцию RasAdminFreeBuffer .
pcEntriesRead [out]: Указатель на 16-разрядную переменную, которая получает общее количество RAS_PORT_0 структур, возвращаемых в массиве ppRasPort0 .

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

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

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

Значение	Значение
NERR_ItemNotFound	Невозможно перечислить порты. Это может быть связано с тем, что все настроенные порты на сервере в настоящее время используются для исходящих вызовов.

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

Требования

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

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

Общие сведения о службе удаленного доступа (RAS)
Функции администрирования сервера RAS
RAS_PORT_0
RasAdminFreeBuffer

Поделиться через