MSFT_UCCommandTraceEvent class

The MSFT_UCCommandTraceEvent class is an extension of MSFT_UCTraceEventBase. By using this class, you can observe the execution of individual statements in an updating consumer. For statements associated with data queries, there is an event fired for each data object that is returned from the query. The event object that causes the execution of the updating consumer is also stored in this object. These tracing events are represented by MSFT_UCUpdateCommandTraceEvent, MSFT_UCInsertCommandTraceEvent, and MSFT_UCDeleteCommandTraceEvent.

Note  For more information about support and installation of this component on a specific operating system, see Operating System Availability of WMI Components.

Syntax

class MSFT_UCCommandTraceEvent : MSFT_UCTraceEventBase
{
  uint32                CommandIndex;
  MSFT_UpdatingConsumer Consumer;
  object                Data;
  string                ErrorStr;
  __Event               Event;
  string                ExecutionId;
  uint8                 SECURITY_DESCRIPTOR[];
  uint32                StatusCode;
  uint64                TIME_CREATED;
};

Members

The MSFT_UCCommandTraceEvent class has these types of members:

• Properties

Properties

The MSFT_UCCommandTraceEvent class has these properties.

CommandIndex

Data type: uint32

Access type: Read-only

Index of the statement that is being executed. This property is inherited from MSFT_UCTraceEventBase.

Consumer

Data type: MSFT_UpdatingConsumer

Access type: Read-only

Instance of MSFT_UpdatingConsumer that is being executed. This property is inherited from MSFT_UCTraceEventBase.

Data

Data type: object

Access type: Read-only

Data object that is used when executing the statement.

ErrorStr

Data type: string

Access type: Read-only

Information about an error (StatusCode greater than 1). For example, if an updating consumer contains an UPDATE statement that is not valid, the ErrorStr property contains information about the part of the query that is not valid. This property is inherited from MSFT_UCTraceEventBase.

Event

Data type: __Event

Access type: Read-only

Object that contains the event being indicated to the updating consumer instance. This property is inherited from MSFT_UCTraceEventBase.

ExecutionId

Data type: string

Access type: Read-only

Unique identifier that represents the execution of the updating consumer. Each execution of an updating consumer for an event has a unique identifier. The identifier permits correlation of the command trace events because all commands executed for an updating consumer have the same ExecutionId value. This property is inherited from MSFT_UCTraceEventBase.

SECURITY_DESCRIPTOR

Data type: uint8 array

Access type: Read-only

Descriptor that the event provider uses to determine the users that can receive the event. This property is inherited from MSFT_UCTraceEventBase.

StatusCode

Data type: uint32

Access type: Read-only

Status code that represents the outcome of a command or consumer trace event. This property is inherited from MSFT_UCTraceEventBase.

TIME_CREATED

Data type: uint64

Access type: Read-only

Unique value that indicates the time when an event is generated. This is a 64-bit value that represents the number of 100-nanosecond intervals after January 1, 1601. The information is in the Coordinated Universal Time (UTC) format. This property is inherited from MSFT_UCTraceEventBase.

For more information about using uint64 values in scripts, see Scripting in WMI.

Examples

For script code examples, see WMI Tasks for Scripts and Applications and the TechNet ScriptCenter Script Repository.

For C++ code examples, see WMI C++ Application Examples.

Requirements

See also

Using Updating Consumers

MSFT_UCTraceEventBase

Supporting Classes for the Updating Consumer