Функция MprConfigServerSetInfo (mprapi.h)
Функция MprConfigServerSetInfo используется для установки количества портов L2TP, PPTP и SSTP, а также для включения или отключения RRAS в реестре, когда служба RRAS не запущена, чтобы она была выбрана при следующей перезагрузке системы.
Синтаксис
DWORD MprConfigServerSetInfo(
[in] MPR_SERVER_HANDLE hMprServer,
[in] DWORD dwLevel,
[in] LPBYTE lpbBuffer
);
Параметры
[in] hMprServer
Дескриптор конфигурации маршрутизатора. Получите этот дескриптор, вызвав mprConfigServerConnect.
[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.
Если функция завершается сбоем, возвращаемое значение представляет собой один из следующих кодов ошибок.
| Значение | Значение |
|---|---|
|
Вызывающее приложение не имеет достаточных привилегий. |
|
Для такого изменения требуется перезагрузка системы. Измените число портов с помощью вызова MprConfigServerSetInfo и перезагрузки. |
|
Если вы попытаетесь установить число портов, превышающее поддерживаемые системой ограничения, как определено в разделах MPR_SERVER_1 и MPR_SERVER_2 .
Возвращает эту ошибку при попытке задать для числа портов PPTP значение 0. Возвращает эту ошибку, если флаги недопустимы или если lpbBuffer или hMprServer имеет значение NULL. |
|
Недопустимое значение dwLevel. |
|
Недопустимый дескриптор hMprServer. |
|
Используйте FormatMessage , чтобы получить системное сообщение об ошибке, соответствующее возвращаемому коду ошибки. |
Комментарии
Эти изменения в конфигурации сервера являются постоянными, но не влияют на сервер RRAS до его перезапуска.
Примеры
Эта функция используется в разделе Настройка портов L2TP и PPTP локальной службы RRAS .
Требования
| Минимальная версия клиента | Ни одна версия не поддерживается |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | mprapi.h |
| Библиотека | Mprapi.lib |
| DLL | Mprapi.dll |