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

Статья
03/15/2023

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

Синтаксис

DWORD MprConfigInterfaceGetHandle(
  [in]  HANDLE hMprConfig,
  [in]  LPWSTR lpwsInterfaceName,
  [out] HANDLE *phRouterInterface
);

Параметры

[in] hMprConfig

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

[in] lpwsInterfaceName

Указатель на строку Юникода, завершающуюся null, которая указывает имя интерфейса, для которого запрашивается дескриптор конфигурации. Используйте GUID интерфейса в качестве имени интерфейса локальной сети.

[out] phRouterInterface

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

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

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

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

Значение	Значение
ERROR_INVALID_PARAMETER	Параметр hMprConfig имеет значение NULL, параметр lpwsInterfaceName имеет значение NULL или оба параметра имеют значение NULL.
ERROR_NOT_ENOUGH_MEMORY	Недостаточно ресурсов для завершения операции.
ERROR_NO_SUCH_INTERFACE	Указанный интерфейс не найден в конфигурации маршрутизатора.
Другое	Используйте FormatMessage , чтобы получить системное сообщение об ошибке, соответствующее возвращаемому коду ошибки.

Требования

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

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

FormatMessage

MprConfigServerConnect

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

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

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