MprAdminUserGetInfo 함수(mprapi.h)

아티클
03/05/2024

MprAdminUserGetInfo 함수는 특정 사용자에 대한 모든 RAS 정보를 검색합니다.

구문

DWORD MprAdminUserGetInfo(
  [in]  LPCWSTR lpszServer,
  [in]  LPCWSTR lpszUser,
  [in]  DWORD   dwLevel,
  [out] LPBYTE  lpbBuffer
);

매개 변수

[in] lpszServer

master UAS(사용자 계정 하위 시스템)를 사용하여 서버의 이름을 지정하는 유니코드 문자열에 대한 포인터입니다. 원격 액세스 서버가 도메인의 일부인 경우 UAS가 있는 컴퓨터는 주 도메인 컨트롤러 또는 백업 도메인 컨트롤러입니다. 원격 액세스 서버가 도메인의 일부가 아닌 경우 서버 자체는 UAS를 저장합니다. 두 경우 모두 MprAdminGetPDCServer 함수를 호출하여 이 매개 변수의 값을 가져옵니다.

서버 자체가 UAS를 저장하는 경우 이 매개 변수는 NULL일 수 있습니다.

[in] lpszUser

RAS 정보를 가져올 사용자의 이름을 지정하는 유니코드 문자열에 대한 포인터입니다.

[in] dwLevel

이 매개 변수는 0 또는 1일 수 있습니다.

Windows NT Server 4.0 SP3 이상: 이 매개 변수는 0이어야 합니다.

[out] lpbBuffer

RAS_USER_0 또는 RAS_USER_1 구조체에 대한 포인터입니다. 호출자는 이 구조체에 대한 메모리를 할당(및 해제)해야 합니다. 반환이 성공하면 이 구조체에는 지정된 사용자에 대한 RAS 데이터가 포함됩니다.

Windows NT Server 4.0 SP3 이상: dwLevel 매개 변수가 0을 지정하는 경우 lpbBuffer는 RAS_USER_0 구조를 가리킵니다.

반환 값

함수가 성공하면 반환 값이 NO_ERROR.

함수가 실패하면 반환 값은 다음 값 중 하나입니다.

값	의미
ERROR_ACCESS_DENIED	호출자에게 충분한 권한이 없습니다.
ERROR_INVALID_LEVEL	dwLevel 값이 잘못되었습니다.
ERROR_INVALID_PARAMETER	lpbBuffer 가 NULL입니다.
ERROR_NO_SUCH_USER	lpwsUserName으로 지정된 사용자가 lpwsServerName으로 지정된 서버에 존재하지 않습니다.

설명

이 함수는 RRAS 재배포 가능 패키지가 설치된 경우 Windows NT 4.0에서 사용할 수 있습니다. 그러나 RRAS 재배포 가능 패키지와 함께 제공되는 Mprapi.dll 버전은 함수를 MprAdminUserGetInfo가 아닌 RasAdminUserGetInfo로 내보냅니다. 따라서 RRAS 재배포 가능 파일을 사용하는 경우 LoadLibrary 및 GetProcAddress 를 사용하여 이 함수에 액세스합니다.

요구 사항

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