mgmReleaseInterfaceOwnership 函数 (mgm.h)
客户端使用 MgmReleaseInterfaceOwnership 函数放弃接口的所有权。 调用此函数时,将删除由多播组管理器代表客户端维护的所有 MMFE 和指定接口。
语法
DWORD MgmReleaseInterfaceOwnership(
[in] HANDLE hProtocol,
[in] DWORD dwIfIndex,
[in] DWORD dwIfNextHopAddr
);
参数
[in] hProtocol
从之前调用 MgmRegisterMProtocol 获取的协议的句柄。
[in] dwIfIndex
指定要发布的接口的索引。
[in] dwIfNextHopAddr
指定与 dwIfIndex 指定的索引相对应的下一跃点的地址。 dwIfIndex 和 dwIfNextHopIPAddr 参数唯一标识点到多点接口上的下一跃点。 点到多点接口是一个接口连接到多个网络的连接。 点到多点接口的示例包括非广播多访问 (NBMA) 接口和所有拨号客户端连接的内部接口。
对于广播接口 (,例如以太网接口) 或点到点接口(仅由 dwIfIndex 的值标识),请指定零。
返回值
如果函数成功,则返回值NO_ERROR。
如果函数失败,则返回值为以下错误代码之一:
值 | 含义 |
---|---|
|
无法完成对此函数的调用。 |
|
客户端句柄无效,或找不到接口。 |
注解
客户端必须先释放其拥有的所有接口的所有权,然后才能使用 MgmDeRegisterMProtocol 函数注销自身。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 无受支持的版本 |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | mgm.h |
Library | Rtm.lib |
DLL | Rtm.dll |