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

Статья
08/26/2023

Задает новое 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