MprConfigInterfaceTransportAdd 函式 (mprapi.h)

發行項
08/24/2023

MprConfigInterfaceTransportAdd函式會將傳輸通訊協定新增至路由器上的介面組態。

語法

DWORD MprConfigInterfaceTransportAdd(
  [in]           HANDLE hMprConfig,
  [in]           HANDLE hRouterInterface,
  [in]           DWORD  dwTransportId,
  [in, optional] LPWSTR lpwsTransportName,
  [in]           LPBYTE pInterfaceInfo,
  [in]           DWORD  dwInterfaceInfoSize,
  [out]          HANDLE *phRouterIfTransport
);

參數

[in] hMprConfig

路由器組態的控制碼。藉由呼叫 MprConfigServerConnect來取得此控制碼。

[in] hRouterInterface

處理新增指定傳輸的介面組態。呼叫 MprConfigInterfaceCreate、 MprConfigInterfaceGetHandle或 MprConfigInterfaceEnum來取得此控制碼。

[in] dwTransportId

描述要新增至組態之傳輸的 DWORD 值。此參數也會識別傳輸的路由器管理員。下表列出 dwTransportId 可接受的值。

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

[in, optional] lpwsTransportName

Null終止 Unicode 字串的指標，指定所要新增之傳輸的名稱。如果未指定此參數，且傳輸為 IP 或 IPX， MprConfigInterfaceTransportAdd 會使用 IP 或 IPX。如果未指定此參數，而且傳輸不是 IP 或 IPX， MprConfigInterfaceTransportAdd 會將 dwTransportId 參數轉換成字串，並使用該參數做為傳輸名稱。

[in] pInterfaceInfo

資訊標頭的指標，其中包含指定介面和傳輸的資訊。指定傳輸的路由器管理員會解譯這項資訊。使用資訊標頭函式來管理資訊標頭。

[in] dwInterfaceInfoSize

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

[out] phRouterIfTransport

的指標
HANDLE 變數，接收 dwTransportId 參數中指出之這個介面的傳輸組態控制碼類型。

傳回值

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

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

值	意義
ERROR_INVALID_PARAMETER	以下其中一項為正確： hMprConfig 為 Null。 hRouterInterface 為 Null。 phRouterIfTransport 為 Null。
ERROR_NOT_ENOUGH_MEMORY	資源不足，無法完成作業。
其他	使用 FormatMessage 擷取對應至傳回之錯誤碼的系統錯誤訊息。

備註

除了指定傳輸之外， dwTransportId 參數也會指定路由器管理員，因為路由器會維護每個傳輸的唯一路由器管理員。

如果指定的傳輸已經存在， MprConfigInterfaceTransportAdd 會使用指定的參數值來呼叫 MprConfigInterfaceTransportSetInfo 呼叫。

需求


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