SetComputerName

WinApi Функция SetComputerName

Описание:
function SetComputerName(lpComputerName: PChar): BOOL;

Функция устанавливает новое имя NetBIOS локального компьютера. Имя сохраняется в реестре и изменение вступает в силу только после перезапуска системы(компьютера).
Если локальный компьютер является узлом(нодой) в кластере(группе), то устанавливается имя локального компьютера, но не виртуального сервера кластера.

Win 2000/XP: Чтобы установить имя хоста DNS или имя домена DNS, вызывайте функцию SetComputerNameEx.

Параметры:
lpComputerName: Строка содержащая устанавливаемое имя компьютера. Имя не должно быть больше чем MAX_COMPUTERNAME_LENGTH.
Win 95/98/Me: Если строка содержить символы которые вне диапазона набора стандартных символов, то символы принужденно переводятся в стандартный набор.
Win NT/2000/XP: Если строка содержить символы которые вне диапазона набора стандартных символов, то функция возвращает ERROR_INVALID_PARAMETER. Принудительного перевода не происходит.

Стандартный набор символов включает в себя буквы, числа и следующие символы:! @ # $ % ^ & ' ) ( . - _ { } ~.

Возвращаемые значения
Если функция добивается успеха, то возвращаемое значения True.
Если функция терпит неудачу, то False. Чтобы получить расширенную информацию об ошибке, вызовите функцию GetLastError.

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

Материал взят из:
Русская спpавка по Windows API



Последние из рубрики

ОтменитьДобавить комментарий