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

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

  • Статья

Задает пользовательскую конфигурацию туннеля для указанного интерфейса набора номера по запросу на указанном сервере.

Синтаксис

DWORD MprAdminInterfaceSetCustomInfoEx(
  [in] MPR_SERVER_HANDLE    hMprServer,
  [in] HANDLE               hInterface,
  [in] PMPR_IF_CUSTOMINFOEX pCustomInfo
);

Параметры

[in] hMprServer

Дескриптор маршрутизатора для запроса. Этот дескриптор получается при предыдущем вызове функции MprAdminServerConnect .

[in] hInterface

Дескриптор интерфейса. Этот дескриптор получается при предыдущем вызове функции MprAdminInterfaceCreate или MprAdminInterfaceGetHandle .

[in] pCustomInfo

Указатель на структуру MPR_IF_CUSTOMINFOEX , содержащую настраиваемую конфигурацию туннеля.

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

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

Код возврата Описание
ERROR_ACCESS_DENIED
 Вызывающее приложение не имеет достаточных привилегий.
ERROR_INVALID_HANDLE
 Недопустимое значение hInterface .
ERROR_INVALID_PARAMETER
 Параметр pCustomInfo имеет значение NULL или тип интерфейса не ROUTER_IF_TYPE_FULL_ROUTER.
ERROR_NOT_ENOUGH_MEMORY
 Недостаточно ресурсов для завершения операции.

Комментарии

Если необходимо удалить настраиваемую конфигурацию для туннеля IKEv2 интерфейса, вызовите функцию MprAdminInterfaceSetCustomInfoEx с элементом dwFlagsструктуры MPR_IF_CUSTOMINFOEX , для которых задано значение 0.

Если необходимо удалить конфигурацию main режима IKEv2 и политики быстрого режима для интерфейса, задайте для параметра customPolicy члена customIkev2Config в структуре MPR_IF_CUSTOMINFOEXзначение NULL.

Если необходимо удалить сертификат, настроенный для использования во время согласования SA в режиме IKEv2 main, задайте для элемента cbDatacertificateName в элементе customIkev2Configструктуры MPR_IF_CUSTOMINFOEX значение 0.

Требования

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

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

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

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