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