MprAdminInterfaceCreate 函式 (mprapi.h)

發行項
08/24/2023

MprAdminInterfaceCreate函式會在指定的伺服器上建立介面。

語法

DWORD MprAdminInterfaceCreate(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  DWORD             dwLevel,
  [in]  LPBYTE            lpbBuffer,
  [out] HANDLE            *phInterface
);

參數

[in] hMprServer

處理要在其中執行此呼叫的路由器。呼叫 MprAdminServerConnect以取得此控制碼。

[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參數表示結構的類型。

[out] phInterface

HANDLE變數的指標。變數會接收控制碼，以用於所有後續呼叫來管理此介面。

傳回值

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

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

值	意義
ERROR_ACCESS_DENIED	呼叫的應用程式沒有足夠的許可權。
ERROR_DDM_NOT_RUNNING	不支援路由器介面類別型，因為動態介面管理員設定為只在 LAN 上執行。
ERROR_INTERFACE_ALREADY_EXISTS	已經有相同名稱的介面存在。
ERROR_NOT_ENOUGH_MEMORY	資源不足，無法完成作業。
ERROR_NOT_SUPPORTED	dwLevel值無效。

備註

MprAdminInterfaceCreate函式支援MPR_INTERFACE_2結構。不過， MprConfigInterfaceCreate 不會。若要在重新開機後建立持續的需求撥號介面，請使用MPR_INTERFACE_2呼叫MprAdminInterfaceCreate，然後使用MPR_INTERFACE_0或MPR_INTERFACE_1呼叫MprConfigInterfaceCreate。

需求


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