Compartir a través de


Función AddLocalAlternateComputerName

Agrega un nombre de red local alternativo para el equipo desde el que se llama.

Sintaxis

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

Parámetros

lpDnsFQHostname [in]

Nombre alternativo que se va a agregar. El nombre debe estar en el formato ComputerNameDnsFullyQualified tal y como se define en la enumeración COMPUTER_NAME_FORMAT y la función DnsValidateName_W debe poder validarla con su formato establecido en DnsNameHostnameFull.

ulFlags [in]

Este parámetro está reservado y debe establecerse en cero.

Valor devuelto

Si la función se realiza correctamente, la función devuelve ERROR_SUCCESS. Si se produce un error en la función, devuelve un código de error distinto de cero. Entre los códigos de error que devuelve son los siguientes:

Código devuelto Descripción
ERROR_INVALID_PARAMETER
Indica que el parámetro lpDnsFQHostname no apunta a un nombre DNS válido o que el parámetro ulFlags no es igual a cero.
ERROR_NOT_ENOUGH_MEMORY
no hay suficiente memoria para completar la operación.

 

Requisitos

Requisito Value
Biblioteca
Kernel32.lib
Archivo DLL
Kernel32.dll
Nombres Unicode y ANSI
AddLocalAlternateComputerNameW (Unicode) y AddLocalAlternateComputerNameA (ANSI)

Consulte también

COMPUTER_NAME_FORMAT

DnsValidateName_W