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

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

  • Статья

Диспетчер маршрутизатора вызывает функцию 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