Функция AddLocalAlternateComputerName

Статья
06/12/2023

Добавляет альтернативное имя локальной сети для компьютера, с которого он вызывается.

Синтаксис

DWORD AddLocalAlternateComputerName(
  _In_ LPCTSTR lpDnsFQHostname,
  _In_ ULONG   ulFlags
);

Параметры

lpDnsFQHostname [in]: Альтернативное имя, добавляемое. Имя должно быть в формате ComputerNameDnsFullyQualified , как определено в перечислении COMPUTER_NAME_FORMAT , а функция DnsValidateName_W должна иметь возможность проверить его в формате DnsNameHostnameFull.
ulFlags [in]: Этот параметр зарезервирован и должен иметь нулевое значение.

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

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

Код возврата	Описание
ERROR_INVALID_PARAMETER	Указывает, что параметр lpDnsFQHostname не указывает на допустимое DNS-имя или что параметр ulFlags не равен нулю.
ERROR_NOT_ENOUGH_MEMORY	Недостаточно памяти для выполнения запроса.

Требования

Требование	Значение
Библиотека	Kernel32.lib
DLL	Kernel32.dll
Имя в кодировке Юникод и ANSI	AddLocalAlternateComputerNameW (Юникод) и AddLocalAlternateComputerNameA (ANSI)

См. также раздел

COMPUTER_NAME_FORMAT
DnsValidateName_W

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