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를 instance 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 표준 반환 값을 반환할 수 있습니다.
| 반환 코드 | Description |
|---|---|
|
메서드가 완료되었습니다. |
|
지정된 프로세스가 없거나 추적된 COM+ 애플리케이션을 호스팅하지 않습니다. |
|
지정된 구성 요소가 지정된 프로세스에 없습니다. |
설명
프로세스는 애플리케이션 instance ID 또는 프로세스 ID로 선택할 수 있지만 둘 다 선택할 수는 없습니다. 프로세스가 종료된 후 프로세스 ID를 다시 사용할 수 있으므로 애플리케이션 instance ID로 선택하는 것이 좋습니다. 그러나 프로세스 ID별 선택은 프로그램에 대한 명령줄 인수와 같은 다른 원본에서 프로세스 ID를 가져오는 경우에 유용할 수 있습니다.
Summary, Statistics 또는 HangMonitorInfo에 NULL이 아닌 값을 전달하여 구성 요소에 사용할 수 있는 정보를 모두 요청할 수 있습니다. 이러한 매개 변수 중 하나 이상이 NULL이 아니어야 합니다.
요구 사항
| 지원되는 최소 클라이언트 | WINDOWS XP SP2 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2003 SP1 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | comsvcs.h |