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

Статья
03/14/2023

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

Синтаксис

NET_API_STATUS NET_API_FUNCTION NetSetPrimaryComputerName(
  [in, optional] LPCWSTR Server,
  [in]           LPCWSTR PrimaryName,
  [in, optional] LPCWSTR DomainAccount,
  [in, optional] LPCWSTR DomainAccountPassword,
  [in]           ULONG   Reserved
);

Параметры

[in, optional] Server

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

[in] PrimaryName

Указатель на константную строку, указывающую основное имя для задания. Это имя должно быть в виде полного DNS-имени.

[in, optional] DomainAccount

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

Этот параметр не используется, если сервер для выполнения этой функции не присоединен к домену.

[in, optional] DomainAccountPassword

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

Этот параметр игнорируется, если параметр DomainAccount имеет значение NULL. Этот параметр не используется, если сервер для выполнения этой функции не присоединен к домену.

[in] Reserved

Зарезервировано для последующего использования. Этот параметр должен иметь значение NULL.

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

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

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

Код возврата	Описание
ERROR_ACCESS_DENIED	Отказано в доступе". Эта ошибка возвращается, если вызывающий объект не был членом локальной группы администраторов на целевом компьютере.
ERROR_INVALID_NAME	Неправильный параметр имени. Эта ошибка возвращается, если параметр PrimaryName не содержит допустимого имени.
ERROR_INVALID_PARAMETER	Неправильный параметр. Эта ошибка возвращается, если параметр DomainAccount не содержит допустимый домен. Эта ошибка также возвращается, если параметр DomainAccount не равен NULL , а параметр DomainAccountPassword не равен NULL , но не содержит строку Юникода.
ERROR_NOT_ENOUGH_MEMORY	Недостаточно памяти для обработки этой команды.
ERROR_NOT_SUPPORTED	Запрос не поддерживается. Эта ошибка возвращается, если целевой компьютер, указанный в параметре Server , на котором выполняется эта функция, работает в Windows 2000 и более ранних версиях.
NERR_WkstaNotStarted	Служба рабочей станции не запущена.
RPC_S_CALL_IN_PROGRESS	Для этого потока уже выполняется удаленный вызов процедуры.
RPC_S_PROTSEQ_NOT_SUPPORTED	Последовательность протокола удаленного вызова процедур не поддерживается.

Функция NetSetPrimaryComputerName используется в рамках операций переименования компьютера. Указанное имя будет удалено из списка альтернативных имен, настроенного для целевого компьютера и настроенного в качестве основного имени. Имя учетной записи компьютера будет изменено в соответствии с основным именем. Предыдущее имя основного компьютера перемещается в список альтернативных имен компьютеров, настроенный для этого компьютера.

Функция NetSetPrimaryComputerName требует, чтобы вызывающий объект был членом локальной группы "Администраторы" на целевом компьютере.

Требования

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