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

Функция MgmTakeInterfaceOwnership (mgm.h)

  • Статья

Функция MgmTakeInterfaceOwnership вызывается клиентом (например, протоколом маршрутизации), когда она включена в интерфейсе.

Только один клиент может стать владельцем данного интерфейса в любое время. Единственным исключением из этого правила является IGMP. IGMP может сосуществовать с другим клиентом в интерфейсе.

Синтаксис

DWORD MgmTakeInterfaceOwnership(
  [in] HANDLE hProtocol,
  [in] DWORD  dwIfIndex,
  [in] DWORD  dwIfNextHopAddr
);

Параметры

[in] hProtocol

Дескриптор протокола, полученного при предыдущем вызове MgmRegisterMProtocol.

[in] dwIfIndex

Указывает индекс интерфейса, владельцем которого является .

[in] dwIfNextHopAddr

Указывает адрес следующего прыжка, который соответствует индексу, заданному dwIfIndex. Параметры dwIfIndex и dwIfNextHopIPAddr однозначно определяют следующий прыжок в интерфейсах типа "точка — многоточечная". Интерфейс типа "точка — многоточечная" — это подключение, при котором один интерфейс подключается к нескольким сетям. Примеры интерфейсов типа "точка — многоточечная" включают интерфейсы NBMA и внутренний интерфейс, к которому подключаются все клиенты с телефонным подключением.

Для широковещательных интерфейсов (таких как интерфейсы Ethernet) или интерфейсов типа "точка — точка", которые идентифицируются только по значению dwIfIndex, укажите ноль.

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

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

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

Значение Значение
ERROR_ALREADY_EXISTS
 Указанный интерфейс уже принадлежит другому протоколу маршрутизации.
ERROR_CAN_NOT_COMPLETE
 Не удалось завершить вызов этой функции.
ERROR_INVALID_PARAMETER
 Недопустимый дескриптор для клиента.
ERROR_NOT_ENOUGH_MEMORY
 Недостаточно памяти для выполнения этой операции.
 
 

Комментарии

Клиент должен стать владельцем интерфейса только после регистрации в диспетчере групп многоадресной рассылки, но до добавления записей членства в группе.

Требования

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

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

MgmGetProtocolOnInterface

MgmRegisterMProtocol

MgmReleaseInterfaceOwnership