Share via

RasAdminGetUserAccountServer 함수

  • 아티클

[이 함수는 Windows NT Server 4.0과의 이전 버전과의 호환성을 위해서만 제공됩니다. Windows Server 2003에서 ERROR_CALL_NOT_IMPLEMENTED 반환합니다. 애플리케이션은 MprAdminGetPDCServer 함수를 사용해야 합니다.]

RasAdminGetUserAccountServer 함수는 사용자 계정 데이터베이스가 있는 서버의 이름을 검색합니다. RasAdminUserGetInfo 및 RasAdminUserSetInfo 함수에서 반환된 서버 이름을 사용하여 지정된 사용자에 대한 정보를 얻거나 설정합니다.

구문

DWORD RasAdminGetUserAccountServer(
  _In_  const WCHAR  *lpszDomain,
  _In_  const WCHAR  *lpszServer,
  _Out_       LPWSTR lpszUserAccountServer
);

매개 변수

lpszDomain [in]

RAS 서버가 속한 도메인의 이름을 지정하는 null로 끝나는 유니코드 문자열에 대한 포인터입니다. 이 매개 변수는 도메인의 멤버가 아닌 워크스테이션 또는 서버에서 실행되는 RAS 관리 애플리케이션의 경우 NULL 입니다. 이 매개 변수가 NULL인 경우 lpszServer 매개 변수는 NULL이 아닌 매개 변수여야 합니다.

lpszServer [in]

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

lpszUserAccountServer [out]

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

반환 값

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

함수가 실패하면 반환 값은 다음 오류 코드가 될 수 있습니다.

값 의미
ERROR_INVALID_PARAMETER
 lpszDomain과 lpszServer는 모두 NULL입니다.

이 함수에 대한 확장 오류 정보는 없습니다. GetLastError를 호출하지 마세요.

설명

RasAdminGetUserAccountServer 함수는 사용자 계정 데이터베이스를 사용하여 서버의 이름을 가져옵니다. 이 함수에는 RAS 서버의 이름 또는 RAS 서버가 있는 도메인의 이름이 필요합니다.

lpszDomain 매개 변수는 유효한 도메인 이름을 지정해야 합니다. 이 매개 변수는 도메인의 멤버가 아닌 서버에서 실행되는 RAS 관리 애플리케이션의 경우 NULL 입니다(예: 서버가 자체 작업 그룹에 있음). 이 경우 lpszServer 매개 변수는 서버 이름을 지정해야 합니다. 서버 이름을 얻으려면 GetComputerName 함수를 호출합니다. 서버 이름 앞에 "\\" 문자를 접두사로 추가해야 합니다.

lpszServer로 지정된 서버 이름이 독립 실행형 서버인 경우(즉, 서버 또는 워크스테이션이 도메인의 멤버가 아님) 서버 이름 자체가 lpszUserAccountServer 버퍼에 반환됩니다.

그런 다음 NetQueryDisplayInformation 함수를 호출할 때 사용자 계정 서버의 이름을 사용하여 사용자 계정 데이터베이스의 사용자를 열거합니다.

요구 사항

요구 사항 값
클라이언트 지원 종료
 Windows 2000 Professional
서버 지원 종료
 Windows 2000 Server
헤더
Rassapi.h
라이브러리
Rassapi.lib
DLL
Rassapi.dll

추가 정보

RAS(원격 액세스 서비스) 개요

RAS 서버 관리 함수

GetComputerName

RasAdminUserGetInfo

RasAdminUserSetInfo