Platform SDK: Network Management

STD_ALERT

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.

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
Specifies 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
Specifies 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.)
Name Meaning
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
Specifies 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

  Windows NT/2000: Requires Windows NT 3.1 or later.
  Windows 95/98: Unsupported.
  Header: Declared in Lmalert.h.

See Also

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