MprAdminInterfaceTransportGetInfo 函式 (mprapi.h)

  • 發行項

MprAdminInterfaceTransportGetInfo函式會擷取指定介面上執行的傳輸相關資訊。

語法

DWORD MprAdminInterfaceTransportGetInfo(
  [in]            MPR_SERVER_HANDLE hMprServer,
  [in]            HANDLE            hInterface,
  [in]            DWORD             dwTransportId,
  [out]           LPBYTE            *ppInterfaceInfo,
  [out, optional] LPDWORD           lpdwInterfaceInfoSize
);

參數

[in] hMprServer

要從中擷取資訊的路由器控制碼。 呼叫 MprAdminServerConnect以取得此控制碼。

[in] hInterface

介面的控制碼。 此控制碼是從先前呼叫 MprAdminInterfaceCreate取得。

[in] dwTransportId

DWORD值，描述要求資訊的傳輸。 下表列出 dwTransportId 可接受的值。

值 傳輸 (通訊協定系列)
PID_ATALK AppleTalk
PID_IP 網際網路通訊協定第 4 版
PID_IPX 網際網路封包交換
PID_NBF NetBIOS 框架通訊協定
PID_IPV6 Windows Server 2008 或更新版本：網際網路通訊協定第 6 版

[out] ppInterfaceInfo

指標變數的指標。 指標變數指向接收指定介面和傳輸資訊的資訊標頭。 使用 資訊標頭函式 來管理資訊標頭。 呼叫 MprAdminBufferFree來釋放此記憶體。

[out, optional] lpdwInterfaceInfoSize

DWORD變數的指標。 此變數會接收透過 ppInterfaceInfo 參數傳回之介面資訊位元組的大小。

這是選擇性參數。 如果呼叫的應用程式指定此參數的 Null ，函式不會傳回介面資訊的大小。

傳回值

如果函式成功，傳回值會NO_ERROR。

如果函式失敗，傳回值就是下列其中一個錯誤碼。

值 意義
ERROR_ACCESS_DENIED
 呼叫的應用程式沒有足夠的許可權。
ERROR_INVALID_HANDLE
 hInterface值無效，如果指定的介面已系統管理停用，則為 。
ERROR_NO_SUCH_INTERFACE
 指定的傳輸未在指定的介面上執行。
ERROR_NOT_ENOUGH_MEMORY
 資源不足，無法完成作業。
ERROR_UNKNOWN_PROTOCOL_ID
 dwTransportId值不符合任何支援的傳輸。

需求

   
最低支援的用戶端 都不支援
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 mprapi.h
程式庫 Mprapi.lib
Dll Mprapi.dll

另請參閱

MprAdminInterfaceCreate

MprAdminInterfaceTransportSetInfo

MprAdminServerConnect

路由器管理功能

路由器管理參考