Функция MprAdminServerGetInfo (mprapi.h)

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

Синтаксис

DWORD MprAdminServerGetInfo(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpbBuffer
);

Параметры

[in] hMprServer

Дескриптор маршрутизатора для запроса. Получите этот дескриптор, вызвав MprAdminServerConnect.

[in] dwLevel

Значение DWORD, описывающее формат, в котором возвращаются сведения в параметре lplpBuffer . Допустимые значения для dwLevel включают 0, 1 и 2, как указано в следующей таблице.

Значение Формат структуры
0 Windows 2000 Server или более поздней версии: MPR_SERVER_0
1 Windows Server 2003 или более поздней версии: MPR_SERVER_1
2 Windows Server 2008 или более поздней версии: MPR_SERVER_2

[out] lplpbBuffer

При успешном завершении указатель на MPR_SERVER_0MPR_SERVER_1
или MPR_SERVER_2 структуры. Параметр dwLevel указывает тип структуры. Освобождение памяти для этого буфера с помощью MprAdminBufferFree

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

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

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

Значение Значение
ERROR_ACCESS_DENIED
 Вызывающее приложение не имеет достаточных привилегий.
ERROR_INVALID_PARAMETER
 Параметр lplpbBuffer имеет значение NULL.
RPC_S_INVALID_BINDING
 Параметр hMprServer имеет значение NULL.

Требования

Требование Значение
Минимальная версия клиента Ни одна версия не поддерживается
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header mprapi.h
Библиотека Mprapi.lib
DLL Mprapi.dll

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

MPR_SERVER_0

MPR_SERVER_1

MPR_SERVER_2

MprAdminBufferFree

MprAdminServerConnect

MprAdminServerSetInfo

Функции администрирования маршрутизатора

Справочник по управлению маршрутизатором

  • Last updated on