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。

如果函数失败,则返回值为以下错误代码之一。

含义
ERROR_ACCESS_DENIED
调用应用程序没有足够的权限。
ERROR_INTERFACE_NOT_CONNECTED
指定的接口未连接;上次更新的结果不再可用。
ERROR_INVALID_HANDLE
hInterface 值无效。
ERROR_INVALID_PARAMETER
lpdwUpdateResult 参数为 NULL
ERROR_NO_SUCH_INTERFACE
指定的传输未在指定的接口上运行。
ERROR_UNKNOWN_PROTOCOL_ID
dwProtocolId 值与任何受支持的路由器管理器都不匹配。

注解

dwProtocolId 参数指定传输和路由器管理器,因为路由器为每个传输维护一个路由器管理器。

要求

要求
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 mprapi.h
Library Mprapi.lib
DLL Mprapi.dll

另请参阅

MprAdminInterfaceCreate

MprAdminInterfaceUpdateRoutes

MprAdminServerConnect

路由器管理功能

路由器管理参考