функция обратного вызова PMGM_LOCAL_JOIN_CALLBACK (mgm.h)

Статья
08/24/2023

Обратный вызов PMGM_LOCAL_JOIN_CALLBACK — это вызов протокола маршрутизации для уведомления протокола о том, что IGMP обнаружил новые получатели для группы в интерфейсе, который в настоящее время принадлежит протоколу маршрутизации.

Этот обратный вызов вызывается, когда функция MgmAddGroupMembershipEntry вызывается IGMP.

Синтаксис

PMGM_LOCAL_JOIN_CALLBACK PmgmLocalJoinCallback;

DWORD PmgmLocalJoinCallback(
  [in] DWORD dwSourceAddr,
  [in] DWORD dwSourceMask,
  [in] DWORD dwGroupAddr,
  [in] DWORD dwGroupMask,
  [in] DWORD dwIfIndex,
  [in] DWORD dwIfNextHopAddr
)
{...}

Параметры

[in] dwSourceAddr

Указывает исходный адрес, с которого были получены данные многоадресной рассылки. Ноль означает, что данные получены из всех источников (получатель с подстановочными знаками для группы); В противном случае значением dwSourceAddr является IP-адрес исходной или исходной сети.

Чтобы указать диапазон исходных адресов, диспетчер групп многоадресной рассылки указывает исходную сеть с помощью dwSourceAddr, а маску подсети — с помощью dwSourceMask.

[in] dwSourceMask

Указывает маску подсети, соответствующую dwSourceAddr. Параметры dwSourceAddr и dwSourceMask используются вместе для определения диапазона источников, из которых следует получать данные многоадресной рассылки.

Диспетчер групп многоадресной рассылки указывает ноль для этого параметра, если он также указал ноль для dwSourceAddr (приемник с подстановочными знаками).

[in] dwGroupAddr

Указывает группу многоадресной рассылки, для которой предназначены данные. Ноль означает, что получены все группы (получатель с подстановочными знаками); В противном случае значением dwGroupAddr является IP-адрес группы.

Чтобы указать диапазон адресов групп, диспетчер групп многоадресной рассылки указывает адрес группы с помощью dwGroupAddr, а маску подсети — с помощью dwGroupMask.

[in] dwGroupMask

Указывает маску подсети, соответствующую dwGroupAddr. Параметры dwGroupAddr и dwGroupMask используются вместе для определения диапазона групп многоадресной рассылки.

Диспетчер групп многоадресной рассылки указывает ноль для этого параметра, если он также указал ноль для dwGroupAddr (приемник с подстановочными знаками).

[in] dwIfIndex

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

[in] dwIfNextHopAddr

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

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

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

RRAS не ожидает, что приложение вернет какое-либо конкретное значение; Любое возвращаемое значение игнорируется RRAS.

Эта версия API диспетчера групп многоадресной рассылки поддерживает только источники с подстановочными знаками (*, g) или определенные источники (s, g), а не диапазон источников. Такое же ограничение применяется к группам (то есть диапазоны групп не допускаются).

Требования

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

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

PMGM_LOCAL_LEAVE_CALLBACK

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