Función NetMessageBufferSend (lmmsg.h)

Artículo
03/14/2023

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

La función NetMessageBufferSend envía un búfer de información a un alias de mensaje registrado.

Sintaxis

NET_API_STATUS NET_API_FUNCTION NetMessageBufferSend(
  [in] LPCWSTR servername,
  [in] LPCWSTR msgname,
  [in] LPCWSTR fromname,
  [in] LPBYTE  buf,
  [in] DWORD   buflen
);

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 al que se debe enviar el búfer de mensajes.

[in] fromname

Puntero a una cadena constante que especifica quién es el mensaje. Si este parámetro es NULL, el mensaje se envía desde el nombre del equipo local.

[in] buf

Puntero a un búfer que contiene el texto del mensaje. Para obtener más información, consulte Búferes de funciones de administración de red.

[in] buflen

Especifica un valor que contiene la longitud, en bytes, del texto del mensaje al que apunta el parámetro buf .

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_NameNotFound	No se encontró el nombre de usuario.
NERR_NetworkError	Error general en el hardware de red.

Comentarios

Si llama a esta función en un controlador de dominio que ejecuta Active Directory, se permite o se deniega el acceso en función de la lista de control de acceso (ACL) para el objeto protegible. La ACL predeterminada solo permite que los administradores de dominio y los operadores de cuenta llamen a esta función. En un servidor miembro o estación de trabajo, solo los administradores y operadores de servidor pueden llamar a esta función. Para obtener más información, consulte Requisitos de seguridad para las funciones de administración de red. Para obtener más información sobre las ACL y las ACL, vea modelo de Access Control.

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