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

Статья
08/24/2023

Функция MprConfigInterfaceCreate создает интерфейс маршрутизатора в указанной конфигурации маршрутизатора.

Синтаксис

DWORD MprConfigInterfaceCreate(
  [in]  HANDLE hMprConfig,
  [in]  DWORD  dwLevel,
  [in]  LPBYTE lpbBuffer,
  [out] HANDLE *phRouterInterface
);

Параметры

[in] hMprConfig

Обработка конфигурации маршрутизатора. Получите этот дескриптор, вызвав MprConfigServerConnect.

[in] dwLevel

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

Значение	Формат структуры
0	MPR_INTERFACE_0
1	MPR_INTERFACE_1
2	MPR_INTERFACE_2
3	Windows Server 2008 или более поздней версии: MPR_INTERFACE_3

[in] lpbBuffer

Указатель на MPR_INTERFACE_0 , MPR_INTERFACE_1
структура MPR_INTERFACE_2 или MPR_INTERFACE_3 . Параметр dwLevel указывает тип структуры.

[out] phRouterInterface

Указатель на переменную дескриптора. Эта переменная получает дескриптор конфигурации интерфейса.

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

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

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

Значение	Значение
ERROR_INVALID_PARAMETER	Хотя бы одно из следующих утверждений верно: hMprConfig имеет значение NULL. Значение dwLevel не равно 0, 1, 2 или 3. lpbBuffer имеет значение NULL phRouterInterface имеет значение NULL
ERROR_NOT_ENOUGH_MEMORY	Недостаточно ресурсов для завершения операции.
Другое	Используйте FormatMessage , чтобы получить системное сообщение об ошибке, соответствующее возвращаемому коду ошибки.

Функция MprAdminInterfaceCreate поддерживает структуру MPR_INTERFACE_2 . Однако MprConfigInterfaceCreate не выполняет. Чтобы создать интерфейс вызова по запросу, который сохраняется после перезагрузки, вызовите MprAdminInterfaceCreate с MPR_INTERFACE_2, а затем вызовите MprConfigInterfaceCreate с MPR_INTERFACE_0 или MPR_INTERFACE_1.

Требования


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