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
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
