Функция 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]
-
Указатель на строку Юникода с пустым завершением, указывающую имя сервера 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 |
|