Compartir a través de

Función NetMessageNameAdd (lmmsg.h)

  • Artículo

[Esta función no se admite a partir de Windows Vista porque no se admite el servicio messenger.]

La función NetMessageNameAdd registra un alias de mensaje en la tabla de nombres de mensaje. La función requiere que se inicie el servicio messenger.

Sintaxis

NET_API_STATUS NET_API_FUNCTION NetMessageNameAdd(
  [in] LPCWSTR servername,
  [in] LPCWSTR msgname
);

Parámetros

[in] servername

Puntero a una cadena constante que especifica el nombre DNS o NetBIOS 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] msgname

Puntero a una cadena constante que especifica el alias de mensaje que se va a agregar. La cadena no puede tener más de 15 caracteres.

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.

Código devuelto Descripción
ERROR_ACCESS_DENIED
 El autor de la llamada no tiene el acceso adecuado para completar la operación.
ERROR_INVALID_PARAMETER
 Un parámetro es incorrecto.
ERROR_NOT_SUPPORTED
 Esta solicitud no se admite. Este error se devuelve en Windows Vista y versiones posteriores.
NERR_AlreadyExists
 El alias del mensaje ya existe en este equipo. Para obtener más información, vea la sección Comentarios que se muestra más adelante.
NERR_DuplicateName
 El nombre especificado ya está en uso como alias de mensaje en la red.
NERR_NetworkError
 Error general en el hardware de red.
NERR_TooManyNames
 Se ha superado el número máximo de alias de mensaje.

Comentarios

Solo los miembros del grupo local Administradores pueden ejecutar correctamente la función NetMessageNameAdd en un servidor remoto.

La marca de acción de reenvío ya no es un parámetro para LAN Manager 2. Función xNetMessageNameAdd porque ya no se admite el reenvío de mensajes. Si la función NetMessageNameAdd detecta que existe una versión reenviada de msgname en la red, se producirá un error en la función NERR_Already_Exists.

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 lmmsg.h (include Lm.h)
Library Netapi32.lib
Archivo DLL Netapi32.dll

Consulte también

Funciones de mensajes

NetMessageNameDel

Funciones de administración de red

Introducción a la administración de redes