MprAdminGetPDCServer 함수(mprapi.h)

아티클
03/13/2024

MprAdminGetPDCServer 함수는 도메인 이름 또는 서버 이름에서 master UAS(사용자 계정 하위 시스템)를 사용하여 서버의 이름을 검색합니다. 도메인 이름 매개 변수 또는 서버 이름 매개 변수는 NULL일 수 있지만 둘 다 그렇지는 않습니다.

구문

DWORD MprAdminGetPDCServer(
  [in]  LPCWSTR lpszDomain,
  [in]  LPCWSTR lpszServer,
  [out] LPWSTR  lpszPDCServer
);

매개 변수

[in] lpszDomain

RAS 서버가 속한 도메인의 이름을 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 도메인에 참여하지 않는 Windows NT/Windows 2000 서버에서 RAS 관리 애플리케이션을 실행하는 경우 이 매개 변수는 NULL일 수 있습니다. 이 매개 변수가 NULL인 경우 lpwsServerName 매개 변수는 NULL이 아니어야 합니다.

[in] lpszServer

Windows NT/Windows 2000 RAS 서버의 이름을 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 앞에 "\" 문자가 있는 이름을 \servername 형식으로 지정합니다. lpwsDomain 매개 변수가 NULL이 아닌 경우 이 매개 변수는 NULL일 수 있습니다.

[out] lpszPDCServer

사용자 계정 데이터베이스가 있는 도메인 컨트롤러의 이름을 포함하는 null로 끝나는 유니코드 문자열을 수신하는 버퍼에 대한 포인터입니다. 버퍼는 서버 이름(UNCLEN +1)을 보유할 수 있을 만큼 커야 합니다. 함수는 반환된 서버 이름 앞에 \ servername 형식의 선행 "\" 문자를 접두사로 추가합니다.

반환 값

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

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

값	의미
ERROR_NO_SUCH_DOMAIN	지정된 도메인이 잘못되었습니다.
NERR_InvalidComputer	lpwsDomainName 매개 변수가 NULL이고 lpwsServerName 매개 변수가 잘못되었습니다.

설명

MprAdminGetPDCServer 함수는 RAS 서버의 이름 또는 RAS 서버가 있는 도메인의 이름을 지정하여 사용자 계정 데이터베이스를 사용하여 서버의 이름을 가져올 수 있습니다. 서버 이름을 얻으려면 GetComputerName 함수를 호출합니다.

lpszServer로 지정된 서버 이름이 도메인의 일부인 경우 MprAdminGetPDCServer에서 반환된 서버는 주 도메인 컨트롤러 또는 백업 도메인 컨트롤러가 됩니다.

lpszServer로 지정된 서버 이름이 독립 실행형 Windows NT/Windows 2000 서버(즉, 서버 또는 워크스테이션이 도메인에 참여하지 않음)인 경우 서버 이름 자체는 lpszUserAccountServer 버퍼에 반환됩니다.

그런 다음 NetQueryDisplayInformation 함수를 호출할 때 사용자 계정 서버의 이름을 사용하여 사용자 계정 데이터베이스의 사용자를 열거할 수 있습니다. MprAdminUserGetInfo 및 MprAdminUserSetInfo 함수에 대한 호출에서 서버 이름을 사용하여 지정된 사용자 계정에 대한 RAS 권한을 얻고 설정할 수도 있습니다.

요구 사항

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