STD_ALERT
TOC
Collapse the table of content
Expand the table of content

STD_ALERT structure

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

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.)

NameMeaning
ALERT_ADMIN_EVENT

An administrator's intervention is required.

ALERT_ERRORLOG_EVENT

An entry was added to the error log.

ALERT_MESSAGE_EVENT

A user or application received a broadcast message.

ALERT_PRINT_EVENT

A print job completed or a print error occurred.

ALERT_USER_EVENT

An application or resource was used.

 

alrt_servicename

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

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Lmalert.h (include Lm.h)

See also

Network Management Overview
Network Management Structures
Alert Functions
ADMIN_OTHER_INFO
ERRLOG_OTHER_INFO
PRINT_OTHER_INFO
USER_OTHER_INFO
NetAlertRaise

 

 

Community Additions

ADD
Show:
© 2016 Microsoft