estructura STD_ALERT (lmalert.h)

Artículo
03/14/2023

La estructura STD_ALERT contiene la hora y la fecha en que se produjo un evento significativo. La estructura también contiene una clase de alerta y el nombre de la aplicación que genera el mensaje de alerta. Debe especificar la estructura STD_ALERT al enviar un mensaje de alerta mediante la función NetAlertRaise .

Sintaxis

typedef struct _STD_ALERT {
  DWORD alrt_timestamp;
  WCHAR alrt_eventname[EVLEN + 1];
  WCHAR alrt_servicename[SNLEN + 1];
} STD_ALERT, *PSTD_ALERT, *LPSTD_ALERT;

Members

alrt_timestamp

Tipo: DWORD

Hora y fecha del evento. Este valor se almacena como el número de segundos transcurridos desde las 00:00:00, 1 de enero de 1970, GMT.

alrt_eventname[EVLEN + 1]

Tipo: WCHAR[EVLEN + 1]

Cadena Unicode que indica la clase de alerta (tipo de evento). Este parámetro puede ser uno de los siguientes valores predefinidos u otra clase de alerta que haya definido para las aplicaciones de red. (El nombre del evento de una alerta puede ser cualquier cadena de texto).

Nombre	Significado
ALERT_ADMIN_EVENT	Se requiere la intervención de un administrador.
ALERT_ERRORLOG_EVENT	Se agregó una entrada al registro de errores.
ALERT_MESSAGE_EVENT	Un usuario o aplicación recibió un mensaje de difusión.
ALERT_PRINT_EVENT	Se ha completado un trabajo de impresión o se ha producido un error de impresión.
ALERT_USER_EVENT	Se usó una aplicación o recurso.

alrt_servicename[SNLEN + 1]

Tipo: WCHAR[SNLEN + 1]

Cadena Unicode que indica la aplicación de servicio que genera el mensaje de alerta.

Comentarios

La estructura de STD_ALERT debe estar seguida de una estructura ADMIN_OTHER_INFO, ERRLOG_OTHER_INFO, PRINT_OTHER_INFO o USER_OTHER_INFO . Opcionalmente, estas estructuras se pueden seguir por datos de longitud variable. La aplicación que llama debe asignar la memoria para todas las estructuras y los datos de longitud variable en un búfer de mensajes de alerta.

Consulte NetAlertRaise para obtener un ejemplo de código que genere una alerta administrativa mediante una estructura de STD_ALERT y una estructura de ADMIN_OTHER_INFO .

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Encabezado	lmalert.h (include Lm.h)