Функция NetUnjoinDomain (lmjoin.h)

Статья
03/05/2024

Функция 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

Указатель на константную строку, указывающую имя учетной записи, используемой при подключении к контроллеру домена. В строке должно быть указано имя netBIOS домена и учетная запись пользователя (например, REDMOND\user) или имя участника-пользователя (UPN) пользователя в виде имени входа в интернет-стиле (например, "someone@example.com"). Если этот параметр имеет значение NULL, используется контекст вызывающего объекта.

[in] lpPassword

Если параметр lpAccount указывает имя учетной записи, этот параметр должен указывать на пароль, используемый при подключении к контроллеру домена. В противном случае этот параметр должен иметь значение NULL.

[in] fUnjoinOptions

Указывает параметры отмены параметров. Если этот параметр имеет значение NETSETUP_ACCT_DELETE, учетная запись отключается при отсоединение. Обратите внимание, что этот параметр не удаляет учетную запись. В настоящее время другие параметры отсоединять не определены.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение будет NERR_Success.

Если функция завершается ошибкой, возвращаемым значением может быть один из следующих кодов ошибок или один из кодов системных ошибок.

Код возврата	Описание
ERROR_INVALID_PARAMETER	Неправильный параметр.
NERR_SetupNotJoined	Компьютер в настоящее время не присоединен к домену.
NERR_SetupDomainController	Этот компьютер является контроллером домена и не может быть отсоединен от домена.

Разъединение (и присоединение) компьютера к домену или рабочей группе может выполняться только членом локальной группы администраторов на целевом компьютере. При удаленном вызове функции NetUnjoinDomain необходимо предоставить учетные данные, так как в этих случаях невозможно делегировать учетные данные.

Разные процессы или разные потоки одного процесса не должны одновременно вызывать функцию NetUnjoinDomain . Эта ситуация может оставить компьютер в несогласованном состоянии.

Для завершения операции требуется перезагрузка системы после вызова функции NetRenameMachineInDomain .

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	lmjoin.h (включая Lm.h)
Библиотека	Netapi32.lib
DLL	Netapi32.dll

См. также раздел

NetJoinDomain

NetRenameMachineInDomain

Функции управления сетью

Общие сведения об управлении сетью

Share via