Поделиться через

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

  • Статья

Функция 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

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

FormatMessage

MprConfigInterfaceDelete

MprConfigServerConnect

Функции конфигурации маршрутизатора

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