Windows Dev Center

MSFT_UCInstanceTraceEvent class

The MSFT_UCInstanceTraceEvent class is derived from MSFT_UCTraceEventBase and provides the ability to trace events at a very granular level. The MSFT_UCInstanceTraceEvent class is subclassed by MSFT_UCInsertInstanceTraceEvent, MSFT_UCDeleteInstanceTraceEvent, and MSFT_UCUpdateInstanceTraceEvent, one of which is fired when any object is modified by the updating consumer.

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_UCInstanceTraceEvent : MSFT_UCTraceEventBase
{
  uint32                CommandIndex;
  MSFT_UpdatingConsumer Consumer;
  object                Data;
  string                ErrorStr;
  object                Event;
  string                ExecutionId;
  object                Inst;
  uint8                 SECURITY_DESCRIPTOR[];
  uint32                StatusCode;
  uint64                TIME_CREATED;
};

Members

The MSFT_UCInstanceTraceEvent class has these types of members:

Properties

The MSFT_UCInstanceTraceEvent class has these properties.

CommandIndex
Data type: uint32
Access type: Read-only

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

Consumer
Data type: MSFT_UpdatingConsumer
Access type: Read-only

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

Data
Data type: object
Access type: Read-only

Object being used when modifying this instance.

ErrorStr
Data type: string
Access type: Read-only

Information in the case of 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 what part of the query is not valid. This property is inherited from MSFT_UCTraceEventBase.

Event
Data type: object
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 a single event has a unique identifier. The identifier permits correlation of the command trace events because all commands executed on behalf of an updating consumer have the same ExecutionId value. This property is inherited from MSFT_UCTraceEventBase.

Inst
Data type: object
Access type: Read-only

Object being modified.

SECURITY_DESCRIPTOR
Data type: uint8 array
Access type: Read-only

Descriptor used by the event provider to determine which users can receive the event. This property is inherited from __Event. This property is inherited from MSFT_UCTraceEventBase.

StatusCode
Data type: uint32
Access type: Read-only

WBEM status code that represents the outcome of the 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 at which the event was 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 Times (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

Minimum supported client

Windows XP

Minimum supported server

None supported

End of client support

Windows XP

Namespace

\root\subscription

MOF

Updprov.mof

DLL

Updprov.dll

See also

Supporting Classes for the Updating Consumer

 

 

Show:
© 2015 Microsoft