컬렉션 개체의 형태로 모든 COM+ 애플리케이션에 대한 추적 데이터를 검색합니다.
구문
HRESULT GetTrackerDataAsCollectionObject(
[out] IUnknown **TopLevelCollection
);
매개 변수
[out] TopLevelCollection
반환할 때 추적기 데이터 컬렉션에 대한 IUnknown 인터페이스입니다.
반환 값
이 메서드는 표준 반환 값 E_INVALIDARG, E_OUTOFMEMORY 및 S_OK 반환할 수 있습니다.
설명
이 메서드는 주로 IComTrackingInfoEvents 이벤트 인터페이스를 구독하는 애플리케이션이 코드를 최소한의 변경으로 IGetAppTrackerData 에 대한 지원을 추가할 수 있도록 하기 위한 것입니다. 이 메서드에서 반환된 개체는 구독자의 IComTrackingInfoEvent::OnNewTrackingInfo 메서드 호출에서 전송된 개체와 동일하므로 이 컬렉션을 탐색하고 구문 분석하기 위한 코드를 다시 사용할 수 있습니다.
애플리케이션은 이 메서드가 새로 업데이트된 추적 데이터를 서버의 제안된 폴링 간격보다 더 자주 반환할 것으로 예상해서는 안 됩니다( IGetAppTrackerData::GetSuggestedPollingInterval 참조).
이 메서드에서 반환된 컬렉션 개체에는 다른 메서드를 호출하여 사용할 수 있는 모든 추적 데이터가 포함되어 있지 않습니다. 특히 재활용 세부 정보 및 중단 모니터링 구성은 제공되지 않습니다.
요구 사항
| 지원되는 최소 클라이언트 | WINDOWS XP SP2 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | WINDOWS Server 2003 SP1 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | comsvcs.h |