MprAdminInterfaceSetCustomInfoEx 函式 (mprapi.h)

  • 發行項

針對指定伺服器上的指定需求撥號介面，設定通道特定的自定義組態。

語法

DWORD MprAdminInterfaceSetCustomInfoEx(
  [in] MPR_SERVER_HANDLE    hMprServer,
  [in] HANDLE               hInterface,
  [in] PMPR_IF_CUSTOMINFOEX pCustomInfo
);

參數

[in] hMprServer

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

[in] hInterface

介面的句柄。 此句柄是由先前呼叫 MprAdminInterfaceCreate 函式或 MprAdminInterfaceGetHandle 函式取得。

[in] pCustomInfo

包含通道特定自定義組態 之MPR_IF_CUSTOMINFOEX 結構的指標。

傳回值

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

傳回碼 Description
ERROR_ACCESS_DENIED
 呼叫的應用程式沒有足夠的許可權。
ERROR_INVALID_HANDLE
 hInterface 值無效。
ERROR_INVALID_PARAMETER
 pCustomInfo 參數為 NULL，或介面類型未ROUTER_IF_TYPE_FULL_ROUTER。
ERROR_NOT_ENOUGH_MEMORY
 資源不足，無法完成作業。

備註

如果您需要刪除介面之 IKEv2 通道的自定義組態，請呼叫 MprAdminInterfaceSetCustomInfoEx 函式，並將 MPR_IF_CUSTOMINFOEX 結構的 dwFlags 成員設定為零。

如果您需要刪除介面的 IKEv2 主要模式和快速模式原則設定，請將 MPR_IF_CUSTOMINFOEX 結構中 customIkev2Config 成員的 customPolicy 參數設定為 NULL。

如果您需要刪除設定為在 IKEv2 主要模式 SA 交涉期間使用的憑證，請將 MPR_IF_CUSTOMINFOEX 結構的customIkev2Config 成員中的 certificateNamecbData 成員設定為 0。

規格需求

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

另請參閱

路由器管理功能

路由器管理參考