MprConfigServerSetInfo 函式 (mprapi.h)

MprConfigServerSetInfo函式可用來設定 L2TP、PPTP 和 SSTP 埠的埠計數，並在 RRAS 服務未執行時啟用或停用登錄中的 RRAS，以便在下次系統重新開機時加以挑選。

語法

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

[in] hMprServer

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

[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_NOT_SUPPORTED	dwLevel 的值無效。
ERROR_INVALID_HANDLE	hMprServer 控制碼無效。
其他	使用 FormatMessage 擷取對應至傳回之錯誤碼的系統錯誤訊息。

伺服器設定的這些變更是持續性的，但在重新開機之前，RRAS 伺服器不會有任何影響。