MprConfigInterfaceCreate 函式 (mprapi.h)

  • 發行項

MprConfigInterfaceCreate函式會在指定的路由器組態中建立路由器介面。

語法

DWORD MprConfigInterfaceCreate(
  [in]  HANDLE hMprConfig,
  [in]  DWORD  dwLevel,
  [in]  LPBYTE lpbBuffer,
  [out] HANDLE *phRouterInterface
);

參數

[in] hMprConfig

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

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

[out] phRouterInterface

控制碼變數的指標。 此變數會接收介面組態的控制碼。

傳回值

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

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

值 意義
ERROR_INVALID_PARAMETER
 至少符合下列其中一項條件：
  • hMprConfig 為 Null
  • dwLevel 不是 0、1、2 或 3。
  • lpbBuffer 為 Null
  • phRouterInterface 為 Null
ERROR_NOT_ENOUGH_MEMORY
 資源不足，無法完成作業。
其他
 使用 FormatMessage 擷取對應至傳回之錯誤碼的系統錯誤訊息。

備註

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

另請參閱

FormatMessage

MprConfigInterfaceDelete

MprConfigServerConnect

路由器設定函式

路由器管理參考