Función NetMessageNameDel (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 NetMessageNameDel elimina 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 NetMessageNameDel(
  [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 del mensaje que se va a eliminar. La cadena no puede tener más de 15 caracteres.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es 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_DelComputerName
 No se puede eliminar un alias de mensaje que también sea un nombre de equipo.
NERR_IncompleteDel
 El alias del mensaje no se eliminó correctamente de todas las redes.
NERR_NameInUse
 El alias del mensaje está actualmente en uso. Vuelva a intentarlo más tarde.
NERR_NotLocalName
 El alias del mensaje no está en el equipo local.

Comentarios

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

Requisitos

   
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

NetMessageNameAdd

Funciones de administración de redes

Introducción a la administración de redes