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

Статья
08/24/2023

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

Синтаксис

DWORD MprConfigInterfaceTransportGetHandle(
  [in]  HANDLE hMprConfig,
  [in]  HANDLE hRouterInterface,
  [in]  DWORD  dwTransportId,
  [out] HANDLE *phRouterIfTransport
);

Параметры

[in] hMprConfig

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

[in] hRouterInterface

Обработка конфигурации интерфейса. Получите этот дескриптор, вызвав MprConfigInterfaceCreate, MprConfigInterfaceGetHandle или MprConfigInterfaceEnum.

[in] dwTransportId

Значение DWORD , описывающее тип дескриптора конфигурации транспорта в параметре phRouterIfTransport . Допустимые значения для dwTransportId перечислены в следующей таблице.

Значение	Транспорт (семейство протоколов)
PID_ATALK	Appletalk
PID_IP	Интернет-протокол версии 4
PID_IPX	Обмен пакетами через Интернет
PID_NBF	Протокол кадров NetBIOS
PID_IPV6	Windows Server 2008 или более поздней версии: протокол Internet Protocol версии 6

[out] phRouterIfTransport

Указатель на
Переменная HANDLE, которая получает тип дескриптора конфигурации транспорта для этого интерфейса, указанный в параметре dwTransportId.

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

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

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

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

Требования

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