AddLocalAlternateComputerName function

Adds an alternate local network name for the computer from which it is called.

Syntax

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

Parameters

lpDnsFQHostname [in]

The alternate name to be added. The name must be in the ComputerNameDnsFullyQualified format as defined in the COMPUTER_NAME_FORMAT enumeration, and the DnsValidateName_W function must be able to validate it with its format set to DnsNameHostnameFull.

ulFlags [in]

This parameter is reserved and must be set to zero.

Return value

If the function succeeds, the function returns ERROR_SUCCESS. If the function fails, it returns a nonzero error code. Among the error codes that it returns are the following:

Return code	Description
ERROR_INVALID_PARAMETER	Indicates that the lpDnsFQHostname parameter does not point to a valid DNS name, or that the ulFlags parameter is not equal to zero.
ERROR_NOT_ENOUGH_MEMORY	There is not enough memory to complete the operation.

 

Requirements

Requirement	Value
Library	Kernel32.lib
DLL	Kernel32.dll
Unicode and ANSI names	AddLocalAlternateComputerNameW (Unicode) and AddLocalAlternateComputerNameA (ANSI)

See also

COMPUTER_NAME_FORMAT

DnsValidateName_W