Export (0) Print
Expand All

IApiTracingDataCollector interface

Logs Win32 calls to Kernel32.dll, Advapi32.dll, Gdi32.dll, and User32.dll. Note that for security reasons, not all function calls are logged.

To create this data collector, call the IDataCollectorCollection::CreateDataCollector or IDataCollectorCollection::CreateDataCollectorFromXml method. For details on the XML that you pass to CreateDataCollectorFromXml, see Remarks.

Members

The IApiTracingDataCollector interface inherits from IDataCollector. IApiTracingDataCollector also has these types of members:

Properties

The IApiTracingDataCollector interface has these properties.

PropertyDescription

ExcludeApis

Retrieves or sets the list of APIs to exclude from the trace.

ExePath

Retrieves or sets the path to the executable file whose API calls you want to trace.

IncludeApis

Retrieves or sets the list of APIs to include in the trace.

IncludeModules

Retrieves or sets the list of modules to include in the trace.

LogApiNamesOnly

Retrieves or sets a value that indicates whether PLA logs only the function name.

LogApisRecursively

Retrieves or sets a value that indicates whether API tracing logs calls that are imported directly by the application.

LogFilePath

Retrieves or sets the name of the log file that contains the API trace data.

 

Remarks

The following example shows the XML that you can use to initialize this object if you call CreateDataCollectorFromXml to create it. The IDataCollector::Xml property also returns this XML.


<ApiTracingDataCollector>
    <ExcludeApis/>
    <ExePath/> 
    <IncludeApis/>
    <IncludeModules/>
    <LogApiNamesOnly/>
    <LogApisRecursively/>
    <LogFilePath/>
</ApiTracingDataCollector>

Note that the example does not show the property elements inherited from IDataCollector that you also need to specify.

When you specify the XML to create the collector, you can specify only the elements for the properties that you want to set. If you do not specify a property, PLA provides a default value. When you retrieve the XML for the collector, the XML provides all elements, including those from IDataCollector.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Pla.h

DLL

Pla.dll

 

 

Community Additions

ADD
Show:
© 2015 Microsoft