Функция 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
Указатель на константную строку, указывающую имя учетной записи, используемой при подключении к контроллеру домена. В строке должно быть указано имя netBIOS домена и учетная запись пользователя (например, REDMOND\user) или имя участника-пользователя (UPN) пользователя в виде имени входа в интернет-стиле (например, "someone@example.com"). Если этот параметр имеет значение NULL, используется контекст вызывающего объекта.
[in] lpPassword
Если параметр lpAccount указывает имя учетной записи, этот параметр должен указывать на пароль, используемый при подключении к контроллеру домена. В противном случае этот параметр должен иметь значение NULL.
[in] fUnjoinOptions
Указывает параметры отмены параметров. Если этот параметр имеет значение NETSETUP_ACCT_DELETE, учетная запись отключается при отсоединение. Обратите внимание, что этот параметр не удаляет учетную запись. В настоящее время другие параметры отсоединять не определены.
Возвращаемое значение
Если функция выполняется успешно, возвращаемое значение будет NERR_Success.
Если функция завершается ошибкой, возвращаемым значением может быть один из следующих кодов ошибок или один из кодов системных ошибок.
| Код возврата | Описание |
|---|---|
|
Неправильный параметр. |
|
Компьютер в настоящее время не присоединен к домену. |
|
Этот компьютер является контроллером домена и не может быть отсоединен от домена. |
Комментарии
Разъединение (и присоединение) компьютера к домену или рабочей группе может выполняться только членом локальной группы администраторов на целевом компьютере. При удаленном вызове функции NetUnjoinDomain необходимо предоставить учетные данные, так как в этих случаях невозможно делегировать учетные данные.
Разные процессы или разные потоки одного процесса не должны одновременно вызывать функцию NetUnjoinDomain . Эта ситуация может оставить компьютер в несогласованном состоянии.
Для завершения операции требуется перезагрузка системы после вызова функции NetRenameMachineInDomain .
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | lmjoin.h (включая Lm.h) |
| Библиотека | Netapi32.lib |
| DLL | Netapi32.dll |