MprConfigInterfaceTransportSetInfo 函式 (mprapi.h)

發行項
03/15/2023

MprConfigInterfaceTransportSetInfo函式會更新指定介面和傳輸通訊協定上用戶端的組態資訊。

語法

DWORD MprConfigInterfaceTransportSetInfo(
  [in]           HANDLE hMprConfig,
  [in]           HANDLE hRouterInterface,
  [in]           HANDLE hRouterIfTransport,
  [in, optional] LPBYTE pInterfaceInfo,
  [in, optional] DWORD  dwInterfaceInfoSize
);

參數

[in] hMprConfig

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

[in] hRouterInterface

要在其中更新資訊的介面組態控制碼。呼叫 MprConfigInterfaceCreate 或 MprConfigInterfaceEnum來取得此控制碼。

[in] hRouterIfTransport

要在其中更新用戶端資訊的傳輸組態控制碼。呼叫 MprConfigInterfaceTransportAdd、 MprConfigInterfaceTransportGetHandle或 MprConfigInterfaceTransportEnum來取得此控制碼。支援的傳輸通訊協定類型列在傳輸識別碼上。

[in, optional] pInterfaceInfo

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

這是選擇性參數。如果呼叫應用程式指定此參數的 Null ，此函式不會更新用戶端的組態資訊。

[in, optional] dwInterfaceInfoSize

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

此參數是選擇性的;呼叫的應用程式可以指定此參數的零。不過，如果 pInterfaceInfo 不是 Null，則此參數不可為零。如需詳細資訊，請參閱本主題稍後的＜備註＞一節。

傳回值

如果函式成功，傳回值會NO_ERROR。如需詳細資訊，請參閱本主題稍後的＜備註＞一節。

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

值	意義
ERROR_INVALID_PARAMETER	至少符合下列其中一項條件： hMprConfig 為 Null。 hRouterInterface 為 Null。 hRouterIfTransport 為 Null。
ERROR_NO_SUCH_INTERFACE	hRouterInterface指定的介面已不存在於路由器設定中，或介面上不再存在hRouterInterface指定的傳輸。
其他	使用 FormatMessage 擷取對應至傳回之錯誤碼的系統錯誤訊息。

備註

如果 pInterfaceInfo 參數為 Null， MprConfigInterfaceTransportSetInfo 不會執行任何動作，並以值為 NO_ERROR 立即傳回。

需求


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