MprAdminInterfaceQueryUpdateResult 函数 (mprapi.h)
MprAdminInterfaceQueryUpdateResult 函数将最后一个请求的结果返回到指定的路由器管理器,以更新接口的路由。 有关详细信息,请参阅 MprAdminInterfaceUpdateRoutes。
语法
DWORD MprAdminInterfaceQueryUpdateResult(
[in] MPR_SERVER_HANDLE hMprServer,
[in] HANDLE hInterface,
[in] DWORD dwProtocolId,
[out] LPDWORD lpdwUpdateResult
);
参数
[in] hMprServer
从中检索信息的路由器的句柄。 通过调用 MprAdminServerConnect 获取此句柄。
[in] hInterface
接口的句柄。 此句柄是从上一次调用 MprAdminInterfaceCreate 获取的。
[in] dwProtocolId
一个 DWORD 值,该值指定要查询的路由器管理器。 路由器为每个传输协议使用不同的路由器管理器。 下表列出了 dwTransportId 的可接受值。
值 | 传输 (协议系列) |
---|---|
PID_ATALK | AppleTalk |
PID_IP | Internet 协议版本 4 |
PID_IPX | Internet 数据包交换 |
PID_NBF | NetBIOS 帧协议 |
PID_IPV6 | Windows Server 2008 或更高版本:Internet 协议版本 6 |
[out] lpdwUpdateResult
指向 DWORD 变量的指针。 此变量接收最后一次调用 MprAdminInterfaceUpdateRoutes 的结果。
返回值
如果函数成功,则返回值NO_ERROR。
如果函数失败,则返回值为以下错误代码之一。
值 | 含义 |
---|---|
|
调用应用程序没有足够的权限。 |
|
指定的接口未连接;上次更新的结果不再可用。 |
|
hInterface 值无效。 |
|
lpdwUpdateResult 参数为 NULL。 |
|
指定的传输未在指定的接口上运行。 |
|
dwProtocolId 值与任何受支持的路由器管理器都不匹配。 |
注解
dwProtocolId 参数指定传输和路由器管理器,因为路由器为每个传输维护一个路由器管理器。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 无受支持的版本 |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | mprapi.h |
Library | Mprapi.lib |
DLL | Mprapi.dll |