MprConfigInterfaceSetInfo 函式 (mprapi.h)

發行項
03/05/2024

MprConfigInterfaceSetInfo 函式會設定指定介面的組態。

語法

DWORD MprConfigInterfaceSetInfo(
  [in] HANDLE hMprConfig,
  [in] HANDLE hRouterInterface,
  [in] DWORD  dwLevel,
  [in] LPBYTE lpbBuffer
);

參數

[in] hMprConfig

路由器組態的句柄。呼叫 MprConfigServerConnect 以取得此句柄。

[in] hRouterInterface

正在更新之介面組態的句柄。呼叫 MprConfigInterfaceCreate、 MprConfigInterfaceGetHandle 或 MprConfigInterfaceEnum 來取得此句柄。

[in] dwLevel

DWORD 值，描述資訊在 lpBuffer 參數中結構化的格式。 dwLevel 可接受的值包括 0、1、2 和 3，如下表所列。

值	結構格式
0	MPR_INTERFACE_0
1	MPR_INTERFACE_1
2	MPR_INTERFACE_2
3	Windows Server 2008 或更新版本： MPR_INTERFACE_3

[in] lpbBuffer

的指標
MPR_INTERFACE_0、 MPR_INTERFACE_1、
MPR_INTERFACE_2或 MPR_INTERFACE_3 結構。 dwLevel 參數表示結構的類型。這個結構中的資訊是用來更新介面組態。

傳回值

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

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

值	意義
ERROR_INVALID_PARAMETER	至少符合下列其中一項條件： hMprConfig 為 NULL。 hRouterInterface 為 NULL。 dwLevel 不是 0、1、2 或 3。 lpBuffer 為 NULL。如果介面的類型為 ROUTER_IF_TYPE_DEDICATED 或 ROUTER_IF_TYPE_INTERNAL 且介面已啟用，也會傳回此錯誤碼。
ERROR_NO_SUCH_INTERFACE	對應至 hRouterInterface 的介面不存在於路由器組態中。
其他	使用 FormatMessage 擷取對應至傳回之錯誤碼的系統錯誤訊息。

備註

MprAdminInterfaceSetInfo 函式支援MPR_INTERFACE_2結構。不過， MprConfigInterfaceSetInfo 不會。若要持續變更需求撥號介面，請使用 MPR_INTERFACE_2 呼叫 MprAdminInterfaceSetInfo，然後使用 MPR_INTERFACE_0 或 MPR_INTERFACE_1 呼叫 MprConfigInterfaceSetInfo。

規格需求

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