Функция RasAdminPortGetInfo
[Эта функция предоставляется только для обратной совместимости с 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]
-
Указатель на строку Юникода, завершающуюся значением NULL, которая указывает имя сервера RAS. Укажите имя с ведущими символами \\" в формате \\servername.
-
lpszPort [in]
-
Указатель на строку Юникода, завершающуюся значением NULL, которая указывает имя порта на сервере.
-
pRasPort1 [out]
-
Указатель на структуру RAS_PORT_1 , которую функция заполняет сведениями о состоянии порта.
-
pRasStats [out]
-
Указатель на структуру RAS_PORT_STATISTICS , которую функция заполняет статистикой по порту.
-
ppRasParams [out]
-
Указатель на переменную указателя, которая получает адрес массива RAS_PARAMETERS структур. Каждая структура содержит имя ключа, зависящее от носителя, например MAXCONNECTBPS, и связанное с ним значение. Когда приложение завершится с этой памятью, освободив его, вызвав функцию RasAdminFreeBuffer .
Возвращаемое значение
Если функция завершается успешно, возвращаемое значение ERROR_SUCCESS.
Если функция завершается ошибкой, возвращаемое значение может быть одним из следующих кодов ошибок.
| Значение | Значение |
|---|---|
|
Указанный порт недопустим. |
|
Недостаточно памяти для выделения буфера для массива ppRasParams . |
Для этой функции нет расширенных сведений об ошибке; не вызывайте GetLastError.
Требования
| Требование | Значение |
|---|---|
| Окончание поддержки клиентов |
Windows 2000 Professional |
| Окончание поддержки сервера |
Windows 2000 Server |
| Заголовок |
|
| Библиотека |
|
| DLL |
|