Edit

IGetAppTrackerData::GetApplicationProcessDetails method (comsvcs.h)

  • Article

Retrieves detailed information about a single process hosting COM+ applications.

Syntax

HRESULT GetApplicationProcessDetails(
  [in]            REFGUID                       ApplicationInstanceId,
  [in]            DWORD                         ProcessId,
  [in]            DWORD                         Flags,
  [out, optional] ApplicationProcessSummary     *Summary,
  [out, optional] ApplicationProcessStatistics  *Statistics,
  [out, optional] ApplicationProcessRecycleInfo *RecycleInfo,
  [out, optional] BOOL                          *AnyComponentsHangMonitored
);

Parameters

[in] ApplicationInstanceId

The application instance GUID that uniquely identifies the tracked process to select, or GUID_NULL if the ProcessId parameter will be used for selection instead.

[in] ProcessId

The process ID that identifies the process to select, or 0 if the ApplicationInstanceId parameter will be used for selection instead.

[in] Flags

A combination of flags from the GetAppTrackerDataFlags enumeration that specify which data is to be returned. The following flags are supported: GATD_INCLUDE_PROCESS_EXE_NAME (if retrieving a summary).

[out, optional] Summary

On return, a ApplicationProcessSummary structure with summary information for the process. This parameter can be NULL.

[out, optional] Statistics

On return, a ApplicationProcessStatistics structure with statistics for the process. This parameter can be NULL.

[out, optional] RecycleInfo

On return, a ApplicationProcessRecycleInfo structure with recycling details for the process. This parameter can be NULL.

[out, optional] AnyComponentsHangMonitored

On return, indicates whether any components in the process are configured for hang monitoring. This parameter can be NULL.

Return value

This method can return the standard return values E_INVALIDARG and E_OUTOFMEMORY, as well as the following values.

Return code Description
S_OK
 The method completed successfully.
COMADMIN_E_APP_NOT_RUNNING
 The specified process does not exist, or is not hosting any tracked COM+ applications.

Remarks

A process may be selected by its application instance ID or its process ID, but not both. Selection by application instance ID is generally preferred, because process IDs may be reused after a process terminates. However, selection by process ID may be useful if you obtain the process ID from some other source, such as a command line argument to your program.

You may request any or all of the information available for the process by passing non-NULL values for Summary, Statistics, RecycleInfo, or AnyComponentsHangMonitored. At least one of these parameters must be non-NULL.

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

See also

IGetAppTrackerData