STD_ALERT structure (lmalert.h)

The STD_ALERT structure contains the time and date when a significant event occurred. The structure also contains an alert class and the name of the application that is raising the alert message. You must specify the STD_ALERT structure when you send an alert message using the NetAlertRaise function.

Syntax

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

Type: DWORD

The time and date of the event. This value is stored as the number of seconds that have elapsed since 00:00:00, January 1, 1970, GMT.

alrt_eventname[EVLEN + 1]

Type: WCHAR[EVLEN + 1]

A Unicode string indicating the alert class (type of event). This parameter can be one of the following predefined values, or another alert class that you have defined for network applications. (The event name for an alert can be any text string.)

alrt_servicename[SNLEN + 1]

Type: WCHAR[SNLEN + 1]

A Unicode string indicating the service application that is raising the alert message.

Remarks

The STD_ALERT structure must be followed by one ADMIN_OTHER_INFO, ERRLOG_OTHER_INFO, PRINT_OTHER_INFO, or USER_OTHER_INFO structure. These structures can optionally be followed by variable-length data. The calling application must allocate the memory for all structures and variable-length data in an alert message buffer.

See NetAlertRaise for a code sample that raises an administrative alert using a STD_ALERT structure and an ADMIN_OTHER_INFO structure.

Requirements

See also

ADMIN_OTHER_INFO

Alert Functions

ERRLOG_OTHER_INFO

NetAlertRaise

Network Management Overview

Network Management Structures

PRINT_OTHER_INFO

USER_OTHER_INFO