NMEVENTDATA structure

The NMEVENTDATA structure contains information about an event condition that is passed to Network Monitor to insert a line in the expert viewer.

Syntax

typedef struct {
  BYTE         Version;
  DWORD        EventIdent;
  DWORD        Flags;
  DWORD        Severity;
  BYTE         NumColumns;
  LPSTR        szSourceName;
  LPSTR        szEventName;
  LPSTR        szDescription;
  LPSTR        szMachine;
  JTYPE        Justification;
  LPSTR        szUrl;
  SYSTEMTIME   SysTime;
  NMCOLUMNINFO Column[];
} NMEVENTDATA, *PNMEVENTDATA;

Members

Version

Version number of the NMEVENTDATA structure. The version number must be zero. Future versions of Network Monitor may support a higher version number.

EventIdent

Identifier of the event. EventIdent is unique to each expert, and references an event reference page.

Flags

A set of flags that describes who sends the event data, and how the event is displayed.

Value	Meaning
EVENT_FLAG_EXPERT	The event came from an expert.
NMEVENTFLAG_DO_NOT_DISPLAY_SEVERITY	Do not display the severity level for the event.
NMEVENTFLAG_DO_NOT_DISPLAY_SOURCE	Do not display the source name for the event.
NMEVENTFLAG_DO_NOT_DISPLAY_EVENT_NAME	Do not display the event name for the event.
NMEVENTFLAG_DO_NOT_DISPLAY_DESCRIPTION	Do not display the description for the event.
NMEVENTFLAG_DO_NOT_DISPLAY_MACHINE	Do not display the machine name for the event.
NMEVENTFLAG_DO_NOT_DISPLAY_TIME	Do not display the time for the event
NMEVENTFLAG_DO_NOT_DISPLAY_FIXED_COLUMNS	Do not display the Severity, Source, Event Name, Description, Machine, or Time columns. This is not a single flag, but it is a union of the previous six flags.

Severity

Severity level of the event. The severity level can have one of the following values:

NMEVENT_SEVERITY_INFORMATIONAL NMEVENT_SEVERITY_WARNING NMEVENT_SEVERITY_STRONG_WARNING NMEVENT_SEVERITY_ERROR NMEVENT_SEVERITY_SEVERE_ERROR NMEVENT_SEVERITY_CRITICAL_ERROR

NumColumns

Number of columns designated in the current structure.

szSourceName

Name of the expert that is displayed.

szEventName

Name of the event that is displayed.

szDescription

Description of the event that is displayed.

szMachine

Obsolete, should be NULL.

Justification

Information displayed in the second window of the Event Viewer. The Justification member may be NULL. If it is NULL, the second window is not be visible.

szUrl

Reserved; this member must be NULL.

SysTime

Time at which the event condition occurs. The time is measured relative to the beginning of the capture.

Column

Table of column structures that appears in the top pane of the Event Viewer.

Requirements

Requirement	Value
Minimum supported client	Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Header	Netmon.h