MSFT_UCExecutedTraceEvent class
The MSFT_UCExecutedTraceEvent class permits you to observe the outcome of executing an updating consumer. The class views all the commands of an updating consumer as a whole, reporting failure if any one command failed and success only if all of the commands executed successfully.
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_UCExecutedTraceEvent : MSFT_UCTraceEventBase
{
uint32 CommandIndex;
MSFT_UpdatingConsumer REF Consumer;
string ErrorStr;
object Event;
string ExecutionId;
uint8 SECURITY_DESCRIPTOR[];
uint32 StatusCode;
uint64 TIME_CREATED;
};
Members
The MSFT_UCExecutedTraceEvent class has these types of members:
- Properties
Properties
The MSFT_UCExecutedTraceEvent class has these properties.
CommandIndex
Data type: uint32
Access type: Read-only
Command in the Commands array of the updating consumer that failed for some reason. If all commands were executed successfully, this property is NULL. This property is inherited from MSFT_UCTraceEventBase.
Consumer
Data type: MSFT_UpdatingConsumer
Access type: Read-only
Reference to the instance of the updating consumer that is being executed. This property is inherited from MSFT_UCTraceEventBase.
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
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.
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 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 |