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

lpbBuffer パラメーターで情報を構造化する形式を表す DWORD 値。 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 サーバーには影響しません。