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

識別要選取之進程的進程標識碼，如果 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+ 應用程式。

備註

進程可由其應用程式實例標識碼或其進程標識碼選取，但不能同時選取兩者。 依應用程式實例識別碼選取通常是慣用的，因為進程標識碼可能會在進程終止之後重複使用。 不過，如果您從其他來源取得進程標識碼，例如您程式的命令行自變數，依進程標識碼選取可能會很有用。

您可以傳遞 Summary、Statistics、RecycleInfo 或 AnyComponentsHangMonitored 的非 NULL 值，以要求進程可用的任何或所有資訊。 其中至少一個參數必須是非 NULL。

規格需求

需求 值
最低支援的用戶端 具有 SP2 的 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 SP1 [僅限傳統型應用程式]
目標平台 Windows
標頭 comsvcs.h

另請參閱

IGetAppTrackerData