通过

IGetAppTrackerData：：GetComponentDetails 方法 (comsvcs.h)

  • 项目

检索有关进程中托管的单个 COM+ 组件的详细信息。

语法

HRESULT GetComponentDetails(
  [in]  REFGUID                  ApplicationInstanceId,
  [in]  DWORD                    ProcessId,
  [in]  REFCLSID                 Clsid,
  [in]  DWORD                    Flags,
  [out] ComponentSummary         *Summary,
  [out] ComponentStatistics      *Statistics,
  [out] ComponentHangMonitorInfo *HangMonitorInfo
);

参数

[in] ApplicationInstanceId

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

[in] ProcessId

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

[in] Clsid

组件的 CLSID。

[in] Flags

GetAppTrackerDataFlags 枚举中的标志组合，用于选择返回的数据。 支持以下标志：GATD_INCLUDE_CLASS_NAME (如果检索摘要) ，GATD_INCLUDE_APPLICATION_NAME (如果检索摘要) 。

[out] Summary

返回时， 为 ComponentSummary 结构，其中包含组件的摘要信息。 此参数可以为 NULL。

[out] Statistics

返回时， 包含组件的统计信息的 ComponentStatistics 结构。 此参数可以为 NULL。

[out] HangMonitorInfo

返回时，为组件配置挂起监视的 ComponentHangMonitorInfo 结构。 此参数可以为 NULL。

返回值

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

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

备注

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

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

要求

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

另请参阅

IGetAppTrackerData