EVT_DebugInfo

Contains data associated with debug events.

Structure

  typedef struct EVT_DebugInfo {
     unsigned int     dsTime;
     unsigned int     milliseconds;
     char             *perpetratorDN;
     char             *formatString;
     int              verb;
     int              paramCount;
     DB_Parameter    *parameters;
  };
  

Fields

dsTime

Specifies the time the event occurred as the number of seconds elapsed since midnight (00:00:00), January 1, 1970, coordinated universal time, according to the system clock.

milliseconds

The millisecond portion of the time the event occurred.

perpetratorDN

The DN of the object that caused this event.

formatString

The format string used to create the string printed in the DS Trace utility. The format string describes the string that is displayed by the DS Trace utility. It contains literal characters as well as format characters that serve as place holder for parameter values. See the remarks for a list of valid format characters.

verb

The ID of the ds verb that was executing when the event occurred.

paramCount

The number of parameters specified in the format string.

parameters

A pointer to an array containing paramCount DB_Parameter structures. The parameters are in the same order as the parameter characters in the format string.

Remarks

The formatString parameter is formatted according to the following:

  %[flags][width][.precision][L,l,h,!]type
  

Element

Description

flags

-, +, #, 0

width

An optional integer indicating the width of the displayed value

precision

An optional integer indicating the precision of the displayed value

L, l, h, !

a character indication the size of the parameter, one of the following values:

  • L: DOUBLE_FLAG

  • l: LONG_FLAG

  • h: SHORT_FLAG

  • !: I64_FLAG

type

A character indicating the data type of the parameter, one of the following values:

C: color (no associated parameter) t: current time (no associated parameter) s: string, EVT_TAG_DB_STRING a: network address U: string, EVT_TAG_DB_STRING T: time stamp V: time stamp vector S: string, EVT_TAG_DB_STRING D: binary data x: hex integer, EVT_TAG_DB_INTEGER v: verb number, EVT_TAG_DB_INTEGER u: unsigned decimal integer, EVT_TAG_DB_INTEGER o: octal integer, EVT_TAG_DB_INTEGER e: error code value, EVT_TAG_DB_INTEGER d: normal decimal integer, EVT_TAG_DB_INTEGER c: single character, EVT_TAG_DB_INTEGER p: raw memory pointer, EVT_TAG_DB_INTEGER X: HEX integer, EVT_TAG_DB_INTEGER E: error code value, EVT_TAG_DB_INTEGER