IaqAQtimeResults Object

Applies to AQTime 8.81, last modified on January 18, 2022

To work with profiling results via COM, use the methods and properties of the IaqAQtimeResults object. To obtain this object, connect to AQTime via COM and then use the Results property of the IntegrationManager object.

Using the methods and properties of the IaqAQtimeResults object you can delete, import, export and merge results. Here is a description of the object’s methods and properties:

Methods and Properties(in alphabetical order) Description
DeleteResult(ResultName) Method. Deletes the result set specified by its name.
ExportResult(FileName, ResultName) Method. Use this method to export the needed result set to a file.

The method has the following parameters:

  • FileName - Specifies the fully-qualified path to a file where the results will be stored.
  • ResultName - Specifies the name of the result set to be stored to a file.

For instance, you can use the following code to export the results stored under the 7/26/2012 5:39:47 PM node in the Explorer panel:

IaqAQtimeResultsObj.ExportResults("C:\AQTimeProjects\Results\ResultFile_1.aqr", "7/26/2012 5:39:47 PM")

If the results have been exported successfully, the method returns True, otherwise - False.

ImportResult(FileName, ResultName) Method. Use this method to load the needed profiling result set from a file.

The method has the following parameters:

  • FileName - Specifies the fully-qualified path to a file where the results are stored.
  • ResultName - Specifies the custom name under which the exported result set will be displayed in the Explorer panel.

If the results have been imported successfully, the method returns True, otherwise - False.

LastResultName(Index) Property. Returns the name of the last result set by its index.

To read the last result set’s name when working via COM, you should use this method. The Index parameter specifies the needed result set. Index is zero-based, and it should be less than the total number of last result sets that is returned by the LastResultCount property. Otherwise, an error occurs.

LastResultsCount Property. Specifies the number of last result sets.
MergedResultName(Index) Property. Returns the name of the merged result set by its index.

To read the merged result set’s name when working via COM, you should use this method. The Index parameter specifies the desired result set. Index is zero-based and it should be less than the total number of merged result sets that is returned by the MergedResultsCount property. Otherwise, an error occurs.

MergedResultsCount Property. Specifies the number of merged result sets.
MergeResults(ResultName1, ResultNmae2, MergedResultName) Method. Use this method to merge two result sets into a new result set.

The method has the following parameters:

  • ResultName1 - Specifies the name of the result set to be merged with another profiler result.
  • ResultName2 - Specifies the name of another result set.
  • MergedResultName - Specifies the name of a new combined result set.

If the results have been merged successfully, the method returns True, otherwise - False.

SavedResultName(Index) Property. Returns the name of the saved result set by its index.

To read the saved result set’s name when working via COM, you should use this method. The Index parameter specifies the needed result set. Index is zero-based and it should be less than the total number of saved result sets that is returned by the SavedResultsCount property. Otherwise, an error occurs.

SavedResultsCount Property. Specifies the number of saved result sets.

See Also

COM Type Reference
Working With AQTime via COM - Overview

Highlight search results