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 因特網通訊協定第 4 版
PID_IPX 因特網封包交換
PID_NBF NetBIOS 框架通訊協定
PID_IPV6 Windows Server 2008 或更新版本：因特網通訊協定第 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
程式庫 Mprapi.lib
Dll Mprapi.dll

另請參閱

MprAdminInterfaceCreate

MprAdminInterfaceUpdateRoutes

MprAdminServerConnect

路由器管理功能

路由器管理參考