Función NetAddAlternateComputerName (lmjoin.h)

Artículo
08/24/2023

La función NetAddAlternateComputerName agrega un nombre alternativo para el equipo especificado.

Sintaxis

NET_API_STATUS NET_API_FUNCTION NetAddAlternateComputerName(
  [in, optional] LPCWSTR Server,
  [in]           LPCWSTR AlternateName,
  [in, optional] LPCWSTR DomainAccount,
  [in, optional] LPCWSTR DomainAccountPassword,
  [in]           ULONG   Reserved
);

Parámetros

[in, optional] Server

Puntero a una cadena constante que especifica el nombre del equipo en el que se va a ejecutar esta función. Si este parámetro es NULL, se usa el equipo local.

[in] AlternateName

Puntero a una cadena constante que especifica el nombre alternativo que se va a agregar. Este nombre debe tener el formato de un nombre DNS completo.

[in, optional] DomainAccount

Puntero a una cadena constante que especifica la cuenta de dominio que se va a usar para acceder al objeto de cuenta de equipo para el equipo especificado en el parámetro Server en Active Directory. Si este parámetro es NULL, se usan las credenciales del usuario que ejecuta esta rutina.

Este parámetro no se usa si el servidor para ejecutar esta función no está unido a un dominio.

[in, optional] DomainAccountPassword

Puntero a una cadena constante que especifica la contraseña que coincide con la cuenta de dominio pasada en el parámetro DomainAccount . Si este parámetro es NULL, se usan las credenciales del usuario que ejecuta esta rutina.

Este parámetro se omite si el parámetro DomainAccount es NULL. Este parámetro no se usa si el servidor para ejecutar esta función no está unido a un dominio.

[in] Reserved

Reservado para uso futuro. Este parámetro debe ser NULL.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto se NERR_Success.

Si se produce un error en la función, el valor devuelto puede ser uno de los siguientes códigos de error o uno de los códigos de error del sistema.

Código devuelto	Descripción
ERROR_ACCESS_DENIED	Se denegó el acceso. Este error se devuelve si el autor de la llamada no era miembro del grupo local Administradores en el equipo de destino.
ERROR_INVALID_NAME	Un parámetro name es incorrecto. Este error se devuelve si el parámetro AlternateName no contiene un nombre válido.
ERROR_INVALID_PARAMETER	Un parámetro es incorrecto. Este error se devuelve si el parámetro DomainAccount no contiene un dominio válido. Este error también se devuelve si el parámetro DomainAccount no es NULL y el parámetro DomainAccountPassword no es NULL , pero no contiene una cadena Unicode.
ERROR_NOT_ENOUGH_MEMORY	No hay suficiente memoria disponible para procesar este comando.
ERROR_NOT_SUPPORTED	No se admite la solicitud. Este error se devuelve si el equipo de destino especificado en el parámetro Server en el que se ejecuta esta función se ejecuta en Windows 2000 y versiones anteriores.
NERR_WkstaNotStarted	No se ha iniciado el servicio Workstation.
RPC_S_CALL_IN_PROGRESS	Ya hay una llamada a procedimiento remoto en curso para este subproceso.
RPC_S_PROTSEQ_NOT_SUPPORTED	No se admite la secuencia de protocolo de llamada a procedimiento remoto.

Comentarios

La función NetAddAlternateComputerName se admite en Windows XP y versiones posteriores.

La función NetAddAlternateComputerName se usa para establecer nombres de red secundarios para equipos. El nombre principal es el nombre que se usa para la autenticación y se asigna al nombre de la cuenta de equipo.

La función NetAddAlternateComputerName requiere que el autor de la llamada sea miembro del grupo local Administradores en el equipo de destino.

Requisitos


Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	lmjoin.h (include Lm.h)
Library	Netapi32.lib
Archivo DLL	Netapi32.dll