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를 instance 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 표준 반환 값을 반환할 수 있습니다.

반환 코드	Description
S_OK	메서드가 완료되었습니다.
COMADMIN_E_APP_NOT_RUNNING	지정된 프로세스가 없거나 추적된 COM+ 애플리케이션을 호스팅하지 않습니다.

설명

프로세스는 애플리케이션 instance ID 또는 프로세스 ID로 선택할 수 있지만 둘 다 선택할 수는 없습니다. 프로세스가 종료된 후 프로세스 ID를 다시 사용할 수 있으므로 애플리케이션 instance ID별 선택이 일반적으로 선호됩니다. 그러나 프로세스 ID별 선택은 프로그램에 대한 명령줄 인수와 같은 다른 원본에서 프로세스 ID를 가져오는 경우에 유용할 수 있습니다.

Summary, Statistics, RecycleInfo 또는 AnyComponentsHangMonitored에 NULL이 아닌 값을 전달하여 프로세스에 사용할 수 있는 정보를 모두 요청할 수 있습니다. 이러한 매개 변수 중 하나 이상이 NULL이 아닌 매개 변수여야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	WINDOWS XP SP2 [데스크톱 앱만 해당]
지원되는 최소 서버	WINDOWS Server 2003 SP1 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	comsvcs.h

추가 정보

IGetAppTrackerData