MprConfigServerSetInfo 함수(mprapi.h)

아티클
08/24/2023

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 정의된 시스템 지원 제한 이상으로 설정하고 topics MPR_SERVER_2. PPTP 포트 수를 0으로 설정하려고 하면 이 오류를 반환합니다. 플래그가 유효하지 않거나 lpbBuffer 또는 hMprServer 가 NULL인 경우 이 오류를 반환합니다.
ERROR_NOT_SUPPORTED	dwLevel 값이 잘못되었습니다.
ERROR_INVALID_HANDLE	hMprServer 핸들이 잘못되었습니다.
기타	FormatMessage를 사용하여 반환된 오류 코드에 해당하는 시스템 오류 메시지를 검색합니다.

설명

서버 구성에 대한 이러한 변경 내용은 영구적이지만 다시 시작될 때까지 RRAS 서버에는 영향을 주지 않습니다.

예제

로컬 RRAS 서비스의 L2TP 및 PPTP 포트 설정 항목에서는 사용 중인 이 함수를 보여 줍니다.

요구 사항


지원되는 최소 클라이언트	지원되는 버전 없음
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	mprapi.h
라이브러리	Mprapi.lib
DLL	Mprapi.dll