Export (0) Print
Expand All

IConfigurationDataCollector interface

Collects computer settings at the time of collection. You can use the configuration information to verify the system state or track changes. PLA saves the configuration information to the file specified in the IDataCollector::FileName property. The contents of the file is XML that is consistent with the TraceRpt.exe schema.

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 IConfigurationDataCollector interface inherits from IDataCollector. IConfigurationDataCollector also has these types of members:

Properties

The IConfigurationDataCollector interface has these properties.

PropertyDescription

FileMaxCount

Retrieves or sets the maximum number of files to collect.

FileMaxRecursiveDepth

Retrieves or sets the maximum number of subfolders from which to recursively collect files.

FileMaxTotalSize

Retrieves or sets the maximum total file size of all files combined that you can collect.

Files

Retrieves or sets the files to collect.

ManagementQueries

Retrieves or sets Windows Management Instrumentation (WMI) queries to run.

QueryNetworkAdapters

Retrieves or sets a value that indicates whether the installed network adapters are queried for their offloading capabilities and other configuration information.

RegistryKeys

Retrieves or sets a list of registry keys to collect.

RegistryMaxRecursiveDepth

Retrieves or sets the maximum number of subkeys from which to recursively collect registry values.

SystemStateFile

Retrieves or sets the name of the file that contains the saved system state.

 

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.


<ConfigurationDataCollector>
    <FileMaxCount/>  
    <FileMaxRecursiveDepth/>  
    <FileMaxTotalSize/>  
    <File/>  <!-- Specify this element for each file -->
    <ManagementQuery/>  <!-- Specify this element for each WMI query -->
    <QueryNetworkAdapters/>
    <RegistryKey/>  <!-- Specify this element for each registry key -->
    <RegistryMaxRecursiveDepth/>
    <SystemStateFile/>  
</ConfigurationDataCollector>

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:
© 2014 Microsoft