NetSetPrimaryComputerName 함수(lmjoin.h)

아티클
08/24/2023

NetSetPrimaryComputerName 함수는 지정된 컴퓨터의 기본 컴퓨터 이름을 설정합니다.

구문

NET_API_STATUS NET_API_FUNCTION NetSetPrimaryComputerName(
  [in, optional] LPCWSTR Server,
  [in]           LPCWSTR PrimaryName,
  [in, optional] LPCWSTR DomainAccount,
  [in, optional] LPCWSTR DomainAccountPassword,
  [in]           ULONG   Reserved
);

매개 변수

[in, optional] Server

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

[in] PrimaryName

설정할 기본 이름을 지정하는 상수 문자열에 대한 포인터입니다. 이 이름은 정규화된 DNS 이름의 형식이어야 합니다.

[in, optional] DomainAccount

Active Directory의 Server 매개 변수에 지정된 컴퓨터의 컴퓨터 계정 개체에 액세스하는 데 사용할 도메인 계정을 지정하는 상수 문자열에 대한 포인터입니다. 이 매개 변수가 NULL이면 이 루틴을 실행하는 사용자의 자격 증명이 사용됩니다.

이 함수를 실행하는 서버가 도메인에 가입되지 않은 경우 이 매개 변수는 사용되지 않습니다.

[in, optional] DomainAccountPassword

DomainAccount 매개 변수에 전달된 도메인 계정과 일치하는 암호를 지정하는 상수 문자열에 대한 포인터입니다. 이 매개 변수가 NULL이면 이 루틴을 실행하는 사용자의 자격 증명이 사용됩니다.

DomainAccount 매개 변수가 NULL인 경우 이 매개 변수는 무시됩니다. 이 함수를 실행하는 서버가 도메인에 가입되지 않은 경우 이 매개 변수는 사용되지 않습니다.

[in] Reserved

다음에 사용하도록 예약됩니다. 이 매개 변수는 NULL이어야 합니다.

반환 값

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

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

반환 코드	설명
ERROR_ACCESS_DENIED	액세스가 거부되었습니다. 이 오류는 호출자가 대상 컴퓨터에서 Administrators 로컬 그룹의 구성원이 아닌 경우 반환됩니다.
ERROR_INVALID_NAME	이름 매개 변수가 잘못되었습니다. PrimaryName 매개 변수에 유효한 이름이 포함되어 있지 않으면 이 오류가 반환됩니다.
ERROR_INVALID_PARAMETER	매개 변수가 잘못되었습니다. DomainAccount 매개 변수에 유효한 도메인이 없는 경우 이 오류가 반환됩니다. DomainAccount 매개 변수가 NULL이 아니고 DomainAccountPassword 매개 변수가 NULL이 아니지만 유니코드 문자열을 포함하지 않는 경우에도 이 오류가 반환됩니다.
ERROR_NOT_ENOUGH_MEMORY	이 명령을 처리하는 데 메모리가 부족합니다.
ERROR_NOT_SUPPORTED	요청이 지원되지 않습니다. 이 오류는 이 함수가 실행되는 Server 매개 변수에 지정된 대상 컴퓨터가 Windows 2000 이하에서 실행되는 경우 반환됩니다.
NERR_WkstaNotStarted	워크스테이션 서비스가 시작되지 않았습니다.
RPC_S_CALL_IN_PROGRESS	이 스레드에 대한 원격 프로시저 호출이 이미 진행 중입니다.
RPC_S_PROTSEQ_NOT_SUPPORTED	원격 프로시저 호출 프로토콜 시퀀스는 지원되지 않습니다.

설명

NetSetPrimaryComputerName 함수는 Windows XP 이상에서 지원됩니다.

NetSetPrimaryComputerName 함수는 컴퓨터 이름 바꾸기 작업의 일부로 사용됩니다. 지정된 이름은 대상 컴퓨터에 대해 구성되고 기본 이름으로 구성된 대체 이름 목록에서 제거됩니다. 컴퓨터 계정 이름이 기본 이름과 일치하도록 변경됩니다. 이전 기본 컴퓨터 이름은 컴퓨터에 대해 구성된 대체 컴퓨터 이름 목록으로 이동됩니다.

NetSetPrimaryComputerName 함수를 사용하려면 호출자가 대상 컴퓨터에서 Administrators 로컬 그룹의 구성원이되어야 합니다.

요구 사항

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