ITraceDataProvider interface (pla.h)
Specifies a trace provider to enable in the trace session.
To get this interface, call the ITraceDataProviderCollection::CreateTraceDataProvider method.
You can also use XML to define the provider. For more information, see the Remarks section of ITraceDataCollector.
Inheritance
The ITraceDataProvider interface inherits from the IDispatch interface. ITraceDataProvider also has these types of members:
Methods
The ITraceDataProvider interface has these methods.
| ITraceDataProvider::get_DisplayName Retrieves or sets the display name of the provider. (Get) |
| ITraceDataProvider::get_FilterData Retrieves or sets arbitrary data that is sent to the trace data provider for filtering purposes. (Get) |
| ITraceDataProvider::get_FilterEnabled Retrieves or sets a value that determines whether the filter data is used to enable the provider. (Get) |
| ITraceDataProvider::get_FilterType Retrieves or sets a provider-defined filter type. (Get) |
| ITraceDataProvider::get_Guid Retrieves or sets the provider's GUID. (Get) |
| ITraceDataProvider::get_KeywordsAll Retrieves the list of keywords that restricts the category of events that you want the provider to write. |
| ITraceDataProvider::get_KeywordsAny Retrieves the list of keywords that determine the category of events that you want the provider to write. |
| ITraceDataProvider::get_Level Retrieves the level of information used to enable the provider. |
| ITraceDataProvider::get_Properties Retrieves the list of extended data items that Event Tracing for Windows (ETW) includes with the event. |
| ITraceDataProvider::GetRegisteredProcesses Retrieves a list of processes that have registered as an Event Tracing for Windows (ETW) provider. |
| ITraceDataProvider::GetSecurity Retrieves the security information for the trace data provider. |
| ITraceDataProvider::put_DisplayName Retrieves or sets the display name of the provider. (Put) |
| ITraceDataProvider::put_FilterData Retrieves or sets arbitrary data that is sent to the trace data provider for filtering purposes. (Put) |
| ITraceDataProvider::put_FilterEnabled Retrieves or sets a value that determines whether the filter data is used to enable the provider. (Put) |
| ITraceDataProvider::put_FilterType Retrieves or sets a provider-defined filter type. (Put) |
| ITraceDataProvider::put_Guid Retrieves or sets the provider's GUID. (Put) |
| ITraceDataProvider::Query Retrieves details about a registered provider. |
| ITraceDataProvider::Resolve Merges the details about a provider with this instance. |
| ITraceDataProvider::SetSecurity Sets the security information for the trace data provider. |
Remarks
If you want to retrieve only the display name or GUID of a specific provider or retrieve only the list of processes registered as that provider, you can get this interface by calling the CoCreateInstance function and passing __uuidof(TraceDataProvider) as the class identifier and __uuidof(ITraceDataProvider) as the interface identifier. To create the object from a script for this purpose, use the Pla.TraceDataProvider program identifier.
Do not use the CoCreateInstance function if you are going to add the interface to the ITraceDataProviderCollection collection.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2008 [desktop apps only] |
| Target Platform | Windows |
| Header | pla.h |