Notify User of an Event

struct user_other_info {
  short alrtus_errcode;
  short alrtus_numstrings;
};
 
/* followed by the consecutive ASCIIZ strings
 
unsigned char mergestrings [][];
unsigned char username[];
unsigned char computername[];
 
*/
 

where:

• alrtus_errcode is the error code for the new message in the message log file.

• alrtus_numstrings indicates the number (0-9) of consecutive ASCIIZ strings that mergestrings contains.

• mergestrings is a series of consecutive ASCIIZ strings that make up the error message indicated by alrtus_errcode.

• username is the name of the user or application affected by the alert.

• computername is the name of the computer that the user or application is accessing.

The ALERT.H header file contains macros to simplify access to the variable-length fields in the alert structure as follows: ┌───────────────────┬──────────────────────────────────────────────────────────┐│MACRO │TASK │
├───────────────────┼──────────────────────────────────────────────────────────┤
│ ALERT_OTHER_INFO, │ When given a pointer to the start of the std_alert data │
│ ALERT_OTHER_INFO_F│ structure, the ALERT_OTHER_INFO macro resolves to a │
│ │ pointer to the variable-length part of the alert message │
│ │ (the information specific to the alert class). When a │
│ │ far pointer is required, use ALERT_OTHER_INFO_F. │
├───────────────────┼──────────────────────────────────────────────────────────┤
│ ALERT_VAR_DATA, │ Works with the data structures defined in the ALERT.H │
│ ALERT_VAR_DATA_F │ header file. Given a pointer to the beginning address │
│ │ of the data structure, ALERT_VAR_DATA returns a pointer │
│ │ to the first variable-length ASCIIZ string. When a far │
│ │ pointer is required, use ALERT_VAR_DATA_F. │
└───────────────────┴──────────────────────────────────────────────────────────┘