mprAdminServerSetInfo 函式 (mprapi.h)

當 RRAS 服務執行時， MprAdminServerSetInfo 函式可用來設定 L2TP、PPTP 和 SSTP 裝置的埠數目。

語法

DWORD MprAdminServerSetInfo(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] DWORD             dwLevel,
  [in] LPBYTE            lpbBuffer
);

[in] hMprServer

要查詢的路由器句柄。呼叫 MprAdminServerConnect 以取得此句柄。

[in] dwLevel

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

值	結構格式
1	Windows Server 2003 或更新版本： MPR_SERVER_1
2	Windows Server 2008 或更新版本： MPR_SERVER_2

[in] lpbBuffer

MPR_SERVER_1的指標
或 MPR_SERVER_2 結構。 dwLevel 參數表示結構的類型。

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

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

值	意義
ERROR_ACCESS_DENIED	呼叫的應用程式沒有足夠的許可權。
ERROR_SUCCESS_REBOOT_REQUIRED	需要系統重新啟動，這類變更才會生效。使用 MprConfigServerSetInfo 呼叫和重新啟動來變更埠計數。
ERROR_INVALID_PARAMETER	如果您嘗試將埠數目設定為超過系統支援的限制，如 MPR_SERVER_1 和 MPR_SERVER_2 主題所定義。如果您嘗試將PPTP埠數目設定為0，則會傳回此錯誤。如果旗標無效或 lpbBuffer 或 hMprServer 為 NULL，則傳回此錯誤。
ERROR_DDM_NOT_RUNNING	RRAS 服務未在此伺服器上執行。
ERROR_NOT_SUPPORTED	dwLevel 的值無效。
ERROR_INVALID_HANDLE	hMprServer 句柄無效。
其他	使用 FormatMessage 擷取對應至傳回之錯誤碼的系統錯誤訊息。

此函式可用來設定 L2TP、PPTP 和 SSTP 連接埠的埠計數，並在服務執行時啟用或停用 RRAS。這些值是持續性的，這表示您不需要透過呼叫 MprConfigServerSetInfo 來追蹤此呼叫。請注意，此函式是異步的，因此您可能不會立即看到變更的影響。