mgmGetProtocolOnInterface 函数 (mgm.h)
MgmGetProtocolOnInterface 函数检索拥有指定接口的多播路由协议的协议 ID。
语法
DWORD MgmGetProtocolOnInterface(
[in] DWORD dwIfIndex,
[in] DWORD dwIfNextHopAddr,
[in, out] PDWORD pdwIfProtocolId,
[in, out] PDWORD pdwIfComponentId
);
参数
[in] dwIfIndex
指定要检索其协议 ID 的接口的索引。
[in] dwIfNextHopAddr
指定与 dwIfIndex 指定的索引相对应的下一跃点的地址。 dwIfIndex 和 dwIfNextHopIPAddr 参数唯一标识点到多点接口上的下一跃点。 点到多点接口是一个接口连接到多个网络的连接。 点到多点接口的示例包括非广播多访问 (NBMA) 接口和所有拨号客户端连接的内部接口。
对于广播接口 (，例如以太网接口) 或点到点接口（仅由 dwIfIndex 的值标识），请指定零。
[in, out] pdwIfProtocolId
输入时，客户端必须提供指向 DWORD 大小的内存位置的指针。
在输出时， pdwIfProtocolId 在 dwIfIndex 指定的接口上接收协议的 ID。
[in, out] pdwIfComponentId
输入时，客户端必须提供指向 DWORD 值的指针。
在输出时， pdwIfComponentId 接收接口上协议实例的组件 ID。 此参数与 pdwIfProtocolId 一起使用，以唯一标识路由协议的实例。
返回值
如果函数成功，则返回值NO_ERROR。
如果函数失败，则返回值为以下错误代码之一。
| 值 | 含义 |
|---|---|
|
无法完成对此函数的调用。 |
|
多播组管理器未找到指定的接口。 |
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 无受支持的版本 |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | mgm.h |
| Library | Rtm.lib |
| DLL | Rtm.dll |