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

Статья
08/24/2023

Функция NetRenameMachineInDomain изменяет имя компьютера в домене.

Синтаксис

NET_API_STATUS NET_API_FUNCTION NetRenameMachineInDomain(
  [in] LPCWSTR lpServer,
  [in] LPCWSTR lpNewMachineName,
  [in] LPCWSTR lpAccount,
  [in] LPCWSTR lpPassword,
  [in] DWORD   fRenameOptions
);

Параметры

[in] lpServer

Указатель на константную строку, указывающую DNS или NetBIOS-имя компьютера, на котором будет вызываться функция. Если этот параметр имеет значение NULL, используется локальный компьютер.

[in] lpNewMachineName

Указатель на константную строку, указывающую новое имя компьютера. Если этот параметр указан, имя локального компьютера также изменяется. Если этот параметр имеет значение NULL, функция предполагает, что вы уже вызвали функцию SetComputerNameEx .

[in] lpAccount

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

[in] lpPassword

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

[in] fRenameOptions

Параметры переименования. Если этот параметр NETSETUP_ACCT_CREATE, функция переименовывает учетную запись в домене.

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

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

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

Код возврата	Описание
ERROR_ACCESS_DENIED	Отказано в доступе". Эта ошибка возвращается, если имя учетной записи, переданное в параметре lpAccount , не имеет достаточных прав доступа для операции.
ERROR_INVALID_PARAMETER	Неправильный параметр.
NERR_SetupNotJoined	В настоящее время компьютер не присоединен к домену.
NERR_SetupDomainController	Этот компьютер является контроллером домена и не может быть отсоединен от домена.

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

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

Возвращаемые значения NERR_SetupNotJoined и NERR_SetupDomainController определяются в файле заголовка Lmerr.h. Этот файл заголовка автоматически включается в файл заголовка Lm.h и не должен включаться напрямую.

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

Требования


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