通过

IGetAppTrackerData：：GetApplicationProcessDetails 方法 (comsvcs.h)

  • 项目

检索有关托管 COM+ 应用程序的单个进程的详细信息。

语法

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
);

参数

[in] ApplicationInstanceId

唯一标识要选择的跟踪进程的应用程序实例 GUID;如果将改用 ProcessId 参数进行选择，则GUID_NULL。

[in] ProcessId

标识要选择的进程的进程 ID;如果改用 ApplicationInstanceId 参数进行选择，则为 0。

[in] Flags

来自 GetAppTrackerDataFlags 枚举的标志的组合，这些标志指定要返回的数据。 支持以下标志：如果检索摘要) ，GATD_INCLUDE_PROCESS_EXE_NAME (。

[out, optional] Summary

返回时，一个 ApplicationProcessSummary 结构，其中包含进程的摘要信息。 此参数可以为 NULL。

[out, optional] Statistics

返回时，一个 ApplicationProcessStatistics 结构，其中包含进程的统计信息。 此参数可以为 NULL。

[out, optional] RecycleInfo

返回时， ApplicationProcessRecycleInfo 结构包含进程的回收详细信息。 此参数可以为 NULL。

[out, optional] AnyComponentsHangMonitored

返回时，指示是否将进程中的任何组件配置为挂起监视。 此参数可以为 NULL。

返回值

此方法可以返回标准返回值E_INVALIDARG和E_OUTOFMEMORY，以及以下值。

返回代码 说明
S_OK
 该方法已成功完成。
COMADMIN_E_APP_NOT_RUNNING
 指定的进程不存在，或者未承载任何跟踪的 COM+ 应用程序。

注解

进程可以按应用程序实例 ID 或进程 ID 选择，但不能同时选择这两者。 通常首选按应用程序实例 ID 进行选择，因为在进程终止后可能会重复使用进程 ID。 但是，如果从其他源（例如程序的命令行参数）获取进程 ID，则按进程 ID 进行选择可能很有用。

可以通过传递 Summary、Statistics、RecycleInfo 或 AnyComponentsHangMonitored 的非 NULL 值来请求进程可用的任何或全部信息。 其中至少一个参数必须为非 NULL。

要求

要求 值
最低受支持的客户端 Windows XP SP2 [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 SP1 [仅限桌面应用]
目标平台 Windows
标头 comsvcs.h

另请参阅

IGetAppTrackerData