The NetErrorLogWrite and Net32ErrorLogWrite APIs return entries in the format of the error_log data structure when the error log file is read. The entry consists of a fixed-length data structure optionally followed by (1) 0 or more ASCIIZ strings (el_text) describing the error message, and (2) a block of raw data (el_data) relating to the cause of the error. Because of the variable lengths and structures of the el_data and el_text portions of the entry, only the fixed-length data structure is defined in the error_log data structure.

The fixed portion of the error log entry has the following format:

struct error_log {
    unsigned short          el_len;
    unsigned short          el_reserved;
    unsigned long           el_time;
    unsigned short          el_error;
    unsigned char           el_name[SNLEN+1];
    unsigned short          el_data_offset; /* offset from beginning
                                         address of error_log */
    unsigned short          el_nstrings;
};
    /* variable-length data specific to the error
     * message and block of data associated with error  */
 
    unsigned char el_text [];         /* error message */
    unsigned char el_data [];
 
/*  raw data - the number of bytes used for raw data is equivalent to:
 *  size = el_len - (el_data_offset + sizeof(el_len)  ); */
    unsigned short el_len;

where:

• el_len indicates the length (in bytes) of the error log entry. (Note that el_len is included at both the beginning and end of the entry to enable both forward and backward scanning of the file.)

• el_reserved is reserved.

• el_time indicates the time when el_name submitted the error entry.

• el_error is the error code for the error. This field can be used to obtain an error message from the NET.MSG file.

• el_name is an ASCIIZ string indicating the name of the network service or application that returned the error entry.

• el_data_offset specifies the byte offset from the beginning of the error log entry to the start of its variable-length portion (el_data).

• el_nstrings indicates the number of ASCIIZ strings the el_text portion of the entry contains.

• el_text points to 0 or more ASCIIZ strings describing the error. These ASCIIZ strings directly follow each error_log structure in the buffer returned by the NetErrorLogRead or Net32ErrorLogRead APIs.

• el_data points to the raw data associated with the error.