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) /core 路由器的会合点。
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
标头 routprot.h

另请参阅

GetNeighbors