Función NetMessageNameDel (lmmsg.h)
[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 |
|---|---|
|
El autor de la llamada no tiene el acceso adecuado para completar la operación. |
|
Un parámetro es incorrecto. |
|
Esta solicitud no se admite. Este error se devuelve en Windows Vista y versiones posteriores. |
|
No se puede eliminar un alias de mensaje que también sea un nombre de equipo. |
|
El alias del mensaje no se eliminó correctamente de todas las redes. |
|
El alias del mensaje está actualmente en uso. Vuelva a intentarlo más tarde. |
|
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 |