IGetAppTrackerData::GetTrackerDataAsCollectionObject-Methode (comsvcs.h)

Ruft Nachverfolgungsdaten für alle COM+-Anwendungen in Form eines Sammlungsobjekts ab.

Syntax

HRESULT GetTrackerDataAsCollectionObject(
  [out] IUnknown **TopLevelCollection
);

Parameter

[out] TopLevelCollection

Bei der Rückgabe wird die IUnknown-Schnittstelle für eine Sammlung von Trackerdaten verwendet.

Rückgabewert

Diese Methode kann die Standardrückgabewerte E_INVALIDARG, E_OUTOFMEMORY und S_OK zurückgeben.

Hinweise

Diese Methode dient in erster Linie dazu, Anwendungen, die die IComTrackingInfoEvents-Ereignisschnittstelle abonnieren, die Unterstützung für IGetAppTrackerData mit minimalen Änderungen am Code hinzuzufügen. Das von dieser Methode zurückgegebene Objekt ist identisch mit dem Objekt, das in Aufrufen der IComTrackingInfoEvent::OnNewTrackingInfo-Methode von Abonnenten gesendet wird, sodass Code zum Navigieren und Analysieren dieser Auflistung wiederverwendet werden kann.

Anwendungen sollten nicht erwarten, dass diese Methode neu aktualisierte Nachverfolgungsdaten häufiger zurückgibt als das vom Server vorgeschlagene Abrufintervall (siehe IGetAppTrackerData::GetSuggestedPollingInterval).

Beachten Sie, dass das von dieser Methode zurückgegebene Auflistungsobjekt nicht alle Nachverfolgungsdaten enthält, die durch Aufrufen der anderen Methoden verfügbar sind. Insbesondere werden keine Recyclingdetails und die Konfiguration der Überwachung zum Aufhängen angegeben.

Anforderungen

Unterstützte Mindestversion (Client)	Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 mit SP1 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	comsvcs.h

Weitere Informationen

IGetAppTrackerData