MprAdminServerSetInfo 함수(mprapi.h)

아티클
08/24/2023

MprAdminServerSetInfo 함수는 RRAS 서비스가 실행 중일 때 L2TP, PPTP 및 SSTP 디바이스에 대한 포트 수를 설정하는 데 사용됩니다.

구문

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

매개 변수

[in] hMprServer

쿼리할 라우터에 대한 핸들입니다. MprAdminServerConnect를 호출하여 이 핸들을 가져옵니다.

[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_DDM_NOT_RUNNING	RRAS 서비스가 이 서버에서 실행되고 있지 않습니다.
ERROR_NOT_SUPPORTED	dwLevel 값이 잘못되었습니다.
ERROR_INVALID_HANDLE	hMprServer 핸들이 잘못되었습니다.
기타	FormatMessage를 사용하여 반환된 오류 코드에 해당하는 시스템 오류 메시지를 검색합니다.

설명

이 함수는 L2TP, PPTP 및 SSTP 포트의 포트 수를 설정하고 서비스가 실행 중일 때 RRAS를 사용하거나 사용하지 않도록 설정하는 데 사용됩니다. 이러한 값은 영구적이므로 MprConfigServerSetInfo를 호출하여 이 호출을 따를 필요가 없습니다. 이 함수는 비동기적이므로 변경 내용의 영향을 즉시 볼 수 없습니다.

예제

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

요구 사항

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