MprAdminInterfaceTransportAdd 函式 (mprapi.h)

  • 發行項

MprAdminInterfaceTransportAdd函式會將傳輸 (例如 IP 或 IPX) 新增至指定的介面。

語法

DWORD MprAdminInterfaceTransportAdd(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwTransportId,
  [in] LPBYTE            pInterfaceInfo,
  [in] DWORD             dwInterfaceInfoSize
);

參數

[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 版

[in] pInterfaceInfo

指定此傳輸之介面資訊的資訊標頭指標。 使用 資訊標頭函式 來管理資訊標頭。

[in] dwInterfaceInfoSize

指定 pInterfaceInfo所指向之資訊的大小，以位元組為單位。

傳回值

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

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

值 意義
ERROR_ACCESS_DENIED
 呼叫的應用程式沒有足夠的許可權。
ERROR_INVALID_HANDLE
 hInterface值無效。
ERROR_INVALID_PARAMETER
 pInterfaceInfo參數為Null。
ERROR_UNKNOWN_PROTOCOL_ID
 dwTransportId值不符合任何支援的傳輸。

備註

dwTransportId參數也會指定路由器管理員，因為路由器會針對每個傳輸使用不同的路由器管理員。

需求

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

另請參閱

MprAdminInterfaceCreate

MprAdminInterfaceTransportRemove

MprAdminServerConnect

路由器管理功能

路由器管理參考