MprAdminInterfaceSetInfo 函式 (mprapi.h)

發行項
02/29/2024

MprAdminInterfaceSetInfo 函式會設定指定伺服器上指定介面的資訊。

語法

DWORD MprAdminInterfaceSetInfo(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwLevel,
  [in] LPBYTE            lpbBuffer
);

參數

[in] hMprServer

要查詢的路由器句柄。此句柄是從先前呼叫 MprAdminServerConnect 取得。

[in] hInterface

先前呼叫 MprAdminInterfaceCreate 所取得的介面句柄。

[in] dwLevel

DWORD 值，描述資訊在 lpbBuffer 參數中結構化的格式。 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_ACCESS_DENIED	呼叫的應用程式沒有足夠的許可權。
ERROR_INVALID_HANDLE	hInterface 值無效。
ERROR_INVALID_PARAMETER	lplpbBuffer 參數為 NULL。
ERROR_NOT_ENOUGH_MEMORY	資源不足，無法完成作業。
ERROR_NOT_SUPPORTED	dwLevel 值無效。

備註

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