Función NetServerComputerNameAdd (lmserver.h)

Artículo
08/24/2023

La función NetServerComputerNameAdd enumera los transportes en los que está activo el servidor especificado y enlaza el nombre del servidor emulado a cada uno de los transportes.

NetServerComputerNameAdd es una función de utilidad que combina la funcionalidad de la función NetServerTransportEnum y la función NetServerTransportAddEx .

Sintaxis

NET_API_STATUS NET_API_FUNCTION NetServerComputerNameAdd(
  [in] LMSTR ServerName,
  [in] LMSTR EmulatedDomainName,
  [in] LMSTR EmulatedServerName
);

Parámetros

[in] ServerName

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

[in] EmulatedDomainName

Puntero a una cadena que contiene el nombre de dominio que debe usar el servidor especificado al anunciar su presencia mediante El NombreMuladoServidor. Este parámetro es opcional.

[in] EmulatedServerName

Puntero a una cadena de caracteres terminada en null que contiene el nombre emulado que el servidor debe comenzar a admitir además del nombre especificado por el parámetro ServerName .

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto se NERR_Success. Tenga en cuenta que NetServerComputerNameAdd se realiza correctamente si el nombre del servidor emulado especificado se agrega al menos a un transporte.

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

Código devuelto	Descripción
ERROR_ACCESS_DENIED	El usuario no tiene acceso a la información pedida.
ERROR_DUP_NAME	Existe un nombre duplicado en la red.
ERROR_INVALID_DOMAINNAME	No se encontró el nombre de dominio en la red.
ERROR_INVALID_PARAMETER	El parámetro especificado no es válido.
ERROR_NOT_ENOUGH_MEMORY	Memoria insuficiente disponible.

Comentarios

Solo los miembros del grupo local Administradores o Operadores de servidor pueden ejecutar correctamente la función NetServerComputerNameAdd .

El servidor especificado por el parámetro ServerName sigue admitiendo todos los nombres que admitía y, además, comienza a admitir nuevos nombres proporcionados por llamadas correctas a la función NetServerComputerNameAdd .

Emulación de nombres que se produce desde una llamada a NetServerComputerNameAdd deja de funcionar cuando el servidor se reinicia o se reinicia. Para interrumpir la emulación de nombres establecida por una llamada anterior a NetServerComputerNameAdd sin reiniciar ni reiniciar, puede llamar a la función NetServerComputerNameDel .

La función NetServerComputerNameAdd se usa normalmente cuando un administrador del sistema reemplaza un servidor, pero quiere mantener la conversión transparente para los usuarios.

Ejemplos

A continuación se muestra un ejemplo de una llamada a la función NetServerComputerNameAdd que solicita que \Server1 responda también a las solicitudes de \Server2.

NetServerComputerNameAdd (Server1, NULL, Server2);

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	lmserver.h (include Lm.h)
Library	Netapi32.lib
Archivo DLL	Netapi32.dll