Функция NetSetPrimaryComputerName (lmjoin.h)
Функция 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.
Если функция завершается ошибкой, возвращаемым значением может быть один из следующих кодов ошибок или один из кодов системных ошибок.
Код возврата | Описание |
---|---|
|
Отказано в доступе". Эта ошибка возвращается, если вызывающий объект не был членом локальной группы администраторов на целевом компьютере. |
|
Неправильный параметр имени. Эта ошибка возвращается, если параметр PrimaryName не содержит допустимого имени. |
|
Неправильный параметр. Эта ошибка возвращается, если параметр DomainAccount не содержит допустимый домен. Эта ошибка также возвращается, если параметр DomainAccount не равен NULL , а параметр DomainAccountPassword не равен NULL , но не содержит строку Юникода. |
|
Недостаточно памяти для обработки этой команды. |
|
Запрос не поддерживается. Эта ошибка возвращается, если целевой компьютер, указанный в параметре Server , на котором выполняется эта функция, работает в Windows 2000 и более ранних версиях. |
|
Служба рабочей станции не запущена. |
|
Для этого потока уже выполняется удаленный вызов процедуры. |
|
Последовательность протокола удаленного вызова процедур не поддерживается. |
Комментарии
Функция NetSetPrimaryComputerName поддерживается в Windows XP и более поздних версиях.
Функция NetSetPrimaryComputerName используется в рамках операций переименования компьютера. Указанное имя будет удалено из списка альтернативных имен, настроенного для целевого компьютера и настроенного в качестве основного имени. Имя учетной записи компьютера будет изменено в соответствии с основным именем. Предыдущее имя основного компьютера перемещается в список альтернативных имен компьютеров, настроенный для этого компьютера.
Функция NetSetPrimaryComputerName требует, чтобы вызывающий объект был членом локальной группы "Администраторы" на целевом компьютере.
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows XP [только классические приложения] |
Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
Целевая платформа | Windows |
Header | lmjoin.h (включая Lm.h) |
Библиотека | Netapi32.lib |
DLL | Netapi32.dll |