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

Статья
08/25/2023

Диспетчер маршрутизатора вызывает функцию GetMfeStatus , чтобы получить состояние записи многоадресной пересылки (MFE) для указанного интерфейса, адреса группы и исходного адреса.

Тип PGET_MFE_STATUS определяет указатель на эту функцию обратного вызова. GetMfeStatus — это заполнитель для имени функции, определяемой приложением.

Синтаксис

PGET_MFE_STATUS PgetMfeStatus;

DWORD PgetMfeStatus(
  [in]  DWORD InterfaceIndex,
  [in]  DWORD GroupAddress,
  [in]  DWORD SourceAddress,
  [out] PBYTE StatusCode
)
{...}

Параметры

[in] InterfaceIndex

Задает индекс интерфейса для этого MFE.

[in] GroupAddress

Указывает адрес группы многоадресной рассылки для этого MFE.

[in] SourceAddress

Указывает адрес источника многоадресной рассылки для этого MFE.

[out] StatusCode

Указатель на переменную BYTE . Протокол маршрутизации должен заполнить эту переменную одним из следующих значений. Протокол маршрутизации должен выбрать наиболее ценный код, который применяется.

Значение	Значение
MFE_NO_ERROR	Ни одно из следующих значений не применяется.
MFE_REACHED_CORE	Локальный компьютер на этом маршрутизаторе является маршрутизатором точки рандеву (RP) или основного маршрутизатора для группы многоадресной рассылки.
MFE_OIF_PRUNED	Это значение должно быть задано только владельцем исходящего интерфейса. Значение указывает, что в исходящем интерфейсе нет подчиненных получателей.
MFE_PRUNED_UPSTREAM	Это значение должно быть задано только владельцем входящего интерфейса. Значение указывает, что черное сообщение было отправлено вышестоящий.
MFE_OLD_ROUTER	Это значение должно быть задано только владельцем входящего интерфейса. Значение указывает, что вышестоящий сосед не поддерживает mtrace.

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

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

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

Значение	Описание
ERROR_CAN_NOT_COMPLETE	Протоколу маршрутизации не удалось выполнить запрос.
ERROR_INVALID_PARAMETER	Недопустимый параметр InterfaceIndex (например, не существует интерфейса с этим индексом) или недопустимый адрес группы или источника.

Эту функцию необходимо реализовать только протоколам многоадресной маршрутизации. Протоколы маршрутизации без многоадресной рассылки должны передавать значение NULL в качестве значения указателя для этой функции в MPR_ROUTING_CHARACTERISTICS

Требования

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

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

GetNeighbors

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