IGetAppTrackerData interface (comsvcs.h)
Enables administrative applications to retrieve statistical information about running COM+ applications.
Inheritance
The IGetAppTrackerData interface inherits from the IUnknown interface. IGetAppTrackerData also has these types of members:
Methods
The IGetAppTrackerData interface has these methods.
| IGetAppTrackerData::GetApplicationProcessDetails Retrieves detailed information about a single process hosting COM+ applications. |
| IGetAppTrackerData::GetApplicationProcesses Retrieves summary information for all processes that are hosting COM+ applications, or for a specified subset of these processes. |
| IGetAppTrackerData::GetApplicationsInProcess Retrieves summary information for all COM+ applications hosted in a single process, or for a specified subset of these applications. |
| IGetAppTrackerData::GetComponentDetails Retrieves detailed information about a single COM+ component hosted in a process. |
| IGetAppTrackerData::GetComponentsInProcess Retrieves summary information for all COM+ components hosted in a single process, or for a specified subset of these components. |
| IGetAppTrackerData::GetSuggestedPollingInterval Retrieves the minimum interval for polling suggested by the Tracker Server. |
| IGetAppTrackerData::GetTrackerDataAsCollectionObject Retrieves tracking data for all COM+ applications in the form of a collection object. |
Remarks
Applications that use tracker data will usually need to poll the Tracker Server periodically to ensure that this data is up-to-date. For example, an administrative application that displays tracking data to the user would typically want this data to be near as possible to real-time. However, polling too frequently can degrade overall system performance. Also keep in mind that the COM+ applications updating the data do not send updates to the Tracker Server immediately, so even in the best case there will be some delay (typically only a few seconds).
Polling frequency is a global policy that administrators can adjust, if necessary, to balance between freshness of data and performance impact for the particular set of tools in use on the systems they manage. The value returned in PollingIntervalInSeconds is the minimum amount of time that an application should wait after retrieving tracking data before making another call to retrieve the same data. Any application that polls the Tracker Server should call this method and adjust their polling behavior accordingly.
The polling interval is by default equal to the tracking event frequency (three seconds). This value can be adjusted by writing the following DWORD registry value:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\COM3\TrackingInfoPollingFrequency = minimum polling interval in seconds
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP with SP2 [desktop apps only] |
| Minimum supported server | Windows Server 2003 with SP1 [desktop apps only] |
| Target Platform | Windows |
| Header | comsvcs.h |