NetUnjoinDomain 함수(lmjoin.h)

NetUnjoinDomain 함수는 작업 그룹 또는 도메인에서 컴퓨터를 연결 해제합니다.

구문

NET_API_STATUS NET_API_FUNCTION NetUnjoinDomain(
  [in] LPCWSTR lpServer,
  [in] LPCWSTR lpAccount,
  [in] LPCWSTR lpPassword,
  [in] DWORD   fUnjoinOptions
);

매개 변수

[in] lpServer

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

[in] lpAccount

도메인 컨트롤러에 연결할 때 사용할 계정 이름을 지정하는 상수 문자열에 대한 포인터입니다. 문자열은 인터넷 스타일 로그인 이름(예: "someone@example.com") 형식으로 사용자의 도메인 NetBIOS 이름 및 사용자 계정(예: REDMOND\user) 또는 UPN(사용자 계정 이름)을 지정해야 합니다. 이 매개 변수가 NULL이면 호출자의 컨텍스트가 사용됩니다.

[in] lpPassword

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

[in] fUnjoinOptions

조인 해제 옵션을 지정합니다. 이 매개 변수가 NETSETUP_ACCT_DELETE 경우 unjoin이 발생할 때 계정이 비활성화됩니다. 이 옵션은 계정을 삭제하지 않습니다. 현재 다른 결합되지 않은 옵션은 정의되어 있지 않습니다.

반환 값

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

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

반환 코드	설명
ERROR_INVALID_PARAMETER	매개 변수가 잘못되었습니다.
NERR_SetupNotJoined	컴퓨터가 현재 도메인에 가입되어 있지 않습니다.
NERR_SetupDomainController	이 컴퓨터는 도메인 컨트롤러이며 도메인에서 조인 해제할 수 없습니다.

설명

도메인 또는 작업 그룹에 컴퓨터를 조인 해제(및 조인)하는 작업은 대상 컴퓨터의 Administrators 로컬 그룹 구성원만 수행할 수 있습니다. NetUnjoinDomain 함수를 원격으로 호출하는 경우 이러한 상황에서 자격 증명을 위임할 수 없으므로 자격 증명을 제공해야 합니다.

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

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

요구 사항

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

추가 정보

NetJoinDomain

NetRenameMachineInDomain

네트워크 관리 함수

네트워크 관리 개요