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.
함수가 실패하면 반환 값은 다음 오류 코드 또는 시스템 오류 코드 중 하나일 수 있습니다.
| 반환 코드 | 설명 |
|---|---|
|
매개 변수가 잘못되었습니다. |
|
컴퓨터가 현재 도메인에 가입되어 있지 않습니다. |
|
이 컴퓨터는 도메인 컨트롤러이며 도메인에서 조인 해제할 수 없습니다. |
설명
도메인 또는 작업 그룹에 컴퓨터를 조인 해제(및 조인)하는 작업은 대상 컴퓨터의 Administrators 로컬 그룹 구성원만 수행할 수 있습니다. NetUnjoinDomain 함수를 원격으로 호출하는 경우 이러한 상황에서 자격 증명을 위임할 수 없으므로 자격 증명을 제공해야 합니다.
다른 프로세스 또는 동일한 프로세스의 다른 스레드는 NetUnjoinDomain 함수를 동시에 호출해서는 안 됩니다. 이 경우 컴퓨터가 일관되지 않은 상태로 남을 수 있습니다.
작업을 완료하려면 NetRenameMachineInDomain 함수를 호출한 후 시스템을 다시 부팅해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | lmjoin.h(Lm.h 포함) |
| 라이브러리 | Netapi32.lib |
| DLL | Netapi32.dll |