Функция AddLocalAlternateComputerName

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

Синтаксис

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