Функция 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 Профессиональный [только классические приложения] |
| минимальный поддерживаемый сервер | Windows 2000 Server [только классические приложения] |
| целевая платформа | Виндоус |
| заголовка | sysinfoapi.h (включая Windows.h) |
| библиотеки |
Kernel32.lib |
| DLL | Kernel32.dll |