3.3.4.1 Trace

This event MUST be signaled with the following arguments:

  • Severity: A TRACE_SEVERITY_LEVEL enumeration value indicating the severity of the event.

  • Source: A 4-byte unsigned integer value specifying the implementation-specific source of the trace event (see the dwSource field in section 2.2.2.4.1.7 for more details).

  • MessageId: An implementation-specific unsigned integer that maps to a string describing the event to be traced (see the dwMessage field in section 2.2.2.4.1.7 for more details).

  • Parameter: An implementation-specific null-terminated ANSI string specifying the variable part (if any) of the string identified by MessageId.

If the Trace event is signaled, the Management Server MUST perform the following actions:

  • If the event MUST be traced, as specified in section 2.2.2.3.4, then, for each connection in the Management Connections list, send an MSG_DTCUIC_TRACE message using the connection:

    • The dwSev field MUST be set to the value of the Severity argument.

    • The dwSource field MUST be set to the value of the Source argument.

    • The dwMessage field MUST be set to the value of MessageId argument.

    • If the Parameter argument is non-null:

      • The fHasParam field of the message MUST be set to 0x00000001.

      • The szParam field of the message MUST be set to the Parameter argument.

    • Else if the Parameter argument is null:

      • The fHasParam field of the message MUST be set to 0x00000000.

      • The szParam field of the message MUST be null.