Поделиться через


Функция SetComputerNameA (sysinfoapi.h)

Задает новое netBIOS-имя для локального компьютера. Имя сохраняется в реестре, и изменение имени вступает в силу при следующей перезагрузке компьютера пользователем.

Если локальный компьютер является узлом в кластере, SetComputerName задает NetBIOS-имя локального компьютера, а не виртуального сервера кластера.

Чтобы задать имя узла DNS или доменное имя DNS, вызовите функцию SetComputerNameEx .

Синтаксис

BOOL SetComputerNameA(
  [in] LPCSTR lpComputerName
);

Параметры

[in] lpComputerName

Имя компьютера, которое вступит в силу при следующем запуске компьютера. Имя не должно быть длиннее MAX_COMPUTERNAME_LENGTH символов.

Стандартный набор символов включает буквы, цифры и следующие символы: ! @ # $ % ^ & ' ) ( . - _ { } ~ . Если этот параметр содержит один или несколько символов, которые находятся за пределами стандартной кодировки, setComputerName возвращает ERROR_INVALID_PARAMETER.

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

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

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

Комментарии

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

Примечание

Заголовок sysinfoapi.h определяет SetComputerName в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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

См. также

Имена компьютеров

GetComputerName

GetComputerNameEx

SetComputerNameEx

Функции сведений о системе