NetRenameMachineInDomain 함수(lmjoin.h)

아티클
08/24/2023

NetRenameMachineInDomain 함수는 도메인에 있는 컴퓨터의 이름을 변경합니다.

구문

NET_API_STATUS NET_API_FUNCTION NetRenameMachineInDomain(
  [in] LPCWSTR lpServer,
  [in] LPCWSTR lpNewMachineName,
  [in] LPCWSTR lpAccount,
  [in] LPCWSTR lpPassword,
  [in] DWORD   fRenameOptions
);

매개 변수

[in] lpServer

함수를 호출할 컴퓨터의 DNS 또는 NetBIOS 이름을 지정하는 상수 문자열에 대한 포인터입니다. 이 매개 변수가 NULL이면 로컬 컴퓨터가 사용됩니다.

[in] lpNewMachineName

컴퓨터의 새 이름을 지정하는 상수 문자열에 대한 포인터입니다. 지정한 경우 로컬 컴퓨터 이름도 변경됩니다. 이 매개 변수가 NULL인 경우 함수는 SetComputerNameEx 함수를 이미 호출한 것으로 가정합니다.

[in] lpAccount

도메인 컨트롤러에 연결할 때 사용할 계정 이름을 지정하는 상수 문자열에 대한 포인터입니다. 이 매개 변수가 NULL이면 호출자의 컨텍스트가 사용됩니다.

[in] lpPassword

lpAccount 매개 변수가 계정 이름을 지정하는 경우 이 매개 변수는 도메인 컨트롤러에 연결할 때 사용할 암호를 가리킵니다. 그렇지 않으면 이 매개 변수는 NULL이어야 합니다.

[in] fRenameOptions

이름 바꾸기 옵션입니다. 이 매개 변수가 NETSETUP_ACCT_CREATE 경우 함수는 도메인의 계정 이름을 바꿉니다.

반환 값

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

함수가 실패하면 반환 값은 다음 오류 코드 또는 시스템 오류 코드 중 하나일 수 있습니다.

반환 코드	설명
ERROR_ACCESS_DENIED	액세스가 거부되었습니다. 이 오류는 lpAccount 매개 변수에 전달된 계정 이름에 작업에 대한 충분한 액세스 권한이 없는 경우 반환됩니다.
ERROR_INVALID_PARAMETER	매개 변수가 잘못되었습니다.
NERR_SetupNotJoined	컴퓨터가 현재 도메인에 가입되어 있지 않습니다.
NERR_SetupDomainController	이 컴퓨터는 도메인 컨트롤러이며 도메인에서 연결할 수 없습니다.

설명

도메인 컴퓨터 이름 바꾸기는 대상 컴퓨터에서 Administrators 로컬 그룹의 구성원이고 도메인의 Administrators 그룹의 구성원이거나 도메인에 대한 계정 운영자 권한이 있는 사용자만 수행할 수 있습니다. NetRenameMachineInDomain 함수를 원격으로 호출하는 경우 이러한 상황에서 자격 증명을 위임할 수 없으므로 자격 증명을 제공해야 합니다.

다른 프로세스 또는 동일한 프로세스의 다른 스레드는 NetRenameMachineInDomain 함수를 동시에 호출해서는 안 됩니다. 이 경우 컴퓨터가 일관되지 않은 상태로 남을 수 있습니다.

NERR_SetupNotJoined 및 NERR_SetupDomainController 반환 값은 Lmerr.h 헤더 파일에 정의되어 있습니다. 이 헤더 파일은 Lm.h 헤더 파일에 자동으로 포함되며 직접 포함해서는 안 됩니다.

작업을 완료하려면 NetRenameMachineInDomain 함수를 호출한 후 시스템을 다시 부팅해야 합니다.

요구 사항


지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	lmjoin.h(Lm.h 포함)
라이브러리	Netapi32.lib
DLL	Netapi32.dll