Función NetMessageNameGetInfo (lmmsg.h)

Artículo
08/24/2023

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

La función NetMessageNameGetInfo recupera información sobre un alias de mensaje determinado en la tabla de nombres de mensaje. La función requiere que se inicie el servicio messenger.

Sintaxis

NET_API_STATUS NET_API_FUNCTION NetMessageNameGetInfo(
  [in]  LPCWSTR servername,
  [in]  LPCWSTR msgname,
  [in]  DWORD   level,
  [out] LPBYTE  *bufptr
);

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 para el que se va a devolver información.

[in] level

Especifica el nivel de información de los datos. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
0	Devuelve el alias del mensaje. El parámetro bufptr apunta a una estructura MSG_INFO_0 .
1	Devuelve el alias del mensaje. El parámetro bufptr apunta a una estructura MSG_INFO_1 . Este nivel solo existe por motivos de compatibilidad. No se admite el reenvío de mensajes.

[out] bufptr

Puntero al búfer que recibe los datos. El formato de estos datos depende del valor del parámetro level . El sistema asigna este búfer y se debe liberar mediante la función NetApiBufferFree . Para obtener más información, consulte Network Management Function Buffers (Búferes de funciones de administración de red) y Network Management Function Buffer Lengths (Longitudes de búfer de funciones de administración de red).

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_LEVEL	El valor especificado para el parámetro level no es válido.
ERROR_INVALID_PARAMETER	Un parámetro es incorrecto.
ERROR_NOT_ENOUGH_MEMORY	No hay suficiente memoria disponible.
ERROR_NOT_SUPPORTED	Esta solicitud no se admite. Este error se devuelve en Windows Vista y versiones posteriores.
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 NetMessageNameGetInfo en un servidor remoto.

Para enumerar todos los alias de mensaje de una tabla de nombres de mensaje, puede llamar a la función NetMessageNameEnum .

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