IWDTFTarget2 interface (wdtf.h)

Article
08/04/2021

Defines operations and properties for a testable item.

Inheritance

The IWDTFTarget2 interface inherits from ITracing. IWDTFTarget2 also has these types of members:

Methods

The IWDTFTarget2 interface has these methods.


IWDTFTarget2::Eval Evaluate whether this target matches an SDEL statement.
IWDTFTarget2::get_Context Gets and sets a name-value pair that represents user data for the target.
IWDTFTarget2::get_Type Gets a value that identifies the depot that the target comes from.
IWDTFTarget2::get_WDTF This method gets the main WDTF aggregation object.
IWDTFTarget2::GetInterface Returns an action for the target.
IWDTFTarget2::GetRelations Returns a collection of related targets.
IWDTFTarget2::GetValue Returns a value from the target that is associated with a specified attribute.
IWDTFTarget2::GetValueBool Returns a boolean value from the target that is associated with a specified attribute.
IWDTFTarget2::GetValueLongNumber Returns a long number value from the target that is associated with a specified attribute.
IWDTFTarget2::GetValueLongNumbers Returns a collection of long number values from the target that are associated with a specified attribute.
IWDTFTarget2::GetValueNumber Returns a number value from the target that is associated with a specified attribute.
IWDTFTarget2::GetValueNumbers Returns a collection of number values from the target that are associated with a specified attribute.
IWDTFTarget2::GetValueString Returns a string value from the target that is associated with a specified attribute.
IWDTFTarget2::GetValueStrings Returns a collection of string values from the target that are associated with a specified attribute.
IWDTFTarget2::HasContext Determines whether a given context exists for the target.
IWDTFTarget2::HasInterface Determines whether the target supports a given interface.
IWDTFTarget2::put_Context Learn how the method gets and sets a name-value pair that represents user data for the target.

Remarks

The IWDTFTarget2 interface abstracts the notion of a testable item, which is the central focus of the WDTF object model. You can retrieve instances of the IWDTFTarget2 interface only through other interfaces (such as the IWDTFDeviceDepot2 interface or the IWDTFSystemDepot2 interface).

The lifetime of a target is tied to its creator; that is, if you retrieve a target from the DeviceDepot property, the target will exist as long as the DeviceDepot property exists.

You cannot copy an instance of the IWDTFTarget2 interface. Even if you add a target to a collection, you really just add a reference to the same instance.

Implementation Details

ProgID: (Use the IWDTF aggregation interface to instantiate)

TraceLevel Path: HKCR\WDTF.Target.1\

Note The implementation of this interface is not thread-safe.

Requirements

Requirement	Value
Minimum supported client	Windows XP Professional
Minimum supported server	Windows Server 2008
Target Platform	Windows
Header	wdtf.h