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

Статья
08/24/2023

Функция MprAdminServerSetInfo используется для задания количества портов для устройств L2TP, PPTP и SSTP при запуске службы RRAS.

Синтаксис

DWORD MprAdminServerSetInfo(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] DWORD             dwLevel,
  [in] LPBYTE            lpbBuffer
);

Параметры

[in] hMprServer

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

[in] dwLevel

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

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

[in] lpbBuffer

Указатель на MPR_SERVER_1
или MPR_SERVER_2 структуры. Параметр dwLevel указывает тип структуры.

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

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

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

Значение	Значение
ERROR_ACCESS_DENIED	Вызывающее приложение не имеет достаточных привилегий.
ERROR_SUCCESS_REBOOT_REQUIRED	Для такого изменения требуется перезагрузка системы. Измените число портов с помощью вызова MprConfigServerSetInfo и перезагрузки.
ERROR_INVALID_PARAMETER	Если вы попытаетесь установить число портов, превышающее поддерживаемые системой ограничения, как определено в разделах MPR_SERVER_1 и MPR_SERVER_2 . Возвращает эту ошибку при попытке задать для числа портов PPTP значение 0. Возвращает эту ошибку, если флаги недопустимы или если lpbBuffer или hMprServer имеет значение NULL.
ERROR_DDM_NOT_RUNNING	Служба RRAS не запущена на этом сервере.
ERROR_NOT_SUPPORTED	Недопустимое значение dwLevel .
ERROR_INVALID_HANDLE	Недопустимый дескриптор hMprServer.
Другое	Используйте FormatMessage , чтобы получить системное сообщение об ошибке, соответствующее возвращаемому коду ошибки.

Эта функция используется для установки количества портов L2TP, PPTP и SSTP, а также для включения или отключения RRAS при запуске службы. Эти значения являются постоянными. Это означает, что вам не нужно выполнять этот вызов с помощью вызова MprConfigServerSetInfo. Обратите внимание, что эта функция является асинхронной, поэтому вы можете не сразу увидеть влияние изменений.

Примеры

Эта функция используется в разделе Настройка портов L2TP и PPTP локальной службы RRAS .

Требования

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