IGetAppTrackerData::GetComponentDetails-Methode (comsvcs.h)

Artikel
08/22/2023

Ruft detaillierte Informationen zu einer einzelnen COM+-Komponente ab, die in einem Prozess gehostet wird.

Syntax

HRESULT GetComponentDetails(
  [in]  REFGUID                  ApplicationInstanceId,
  [in]  DWORD                    ProcessId,
  [in]  REFCLSID                 Clsid,
  [in]  DWORD                    Flags,
  [out] ComponentSummary         *Summary,
  [out] ComponentStatistics      *Statistics,
  [out] ComponentHangMonitorInfo *HangMonitorInfo
);

Parameter

[in] ApplicationInstanceId

Die Anwendung instance GUID, die den zu wählenden nachverfolgten Prozess eindeutig identifiziert, oder GUID_NULL, ob stattdessen der ProcessId-Parameter für die Auswahl verwendet wird.

[in] ProcessId

Die Prozess-ID, die den auszuwählenden Prozess identifiziert, oder 0, wenn ApplicationInstanceId stattdessen für die Auswahl verwendet wird.

[in] Clsid

Die CLSID der Komponente.

[in] Flags

Eine Kombination von Flags aus der GetAppTrackerDataFlags-Enumeration , um auszuwählen, welche Daten zurückgegeben werden. Die folgenden Flags werden unterstützt: GATD_INCLUDE_CLASS_NAME (beim Abrufen einer Zusammenfassung), GATD_INCLUDE_APPLICATION_NAME (beim Abrufen einer Zusammenfassung).

[out] Summary

Bei der Rückgabe eine ComponentSummary-Struktur mit Zusammenfassungsinformationen für die Komponente. Dieser Parameter kann NULL sein.

[out] Statistics

Bei der Rückgabe eine ComponentStatistics-Struktur mit Statistiken für die Komponente. Dieser Parameter kann NULL sein.

[out] HangMonitorInfo

Bei der Rückgabe wird eine ComponentHangMonitorInfo-Struktur mit der Konfiguration für die Überwachung der Komponente aufgehängt. Dieser Parameter kann NULL sein.

Rückgabewert

Diese Methode kann die Standardrückgabewerte E_INVALIDARG und E_OUTOFMEMORY sowie die folgenden Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich abgeschlossen.
COMADMIN_E_APP_NOT_RUNNING	Der angegebene Prozess ist nicht vorhanden oder hostet keine nachverfolgten COM+-Anwendungen.
COMADMIN_E_OBJECT_DOES_NOT_EXIST	Die angegebene Komponente ist im angegebenen Prozess nicht vorhanden.

Hinweise

Ein Prozess kann von seiner Anwendung instance-ID oder seiner Prozess-ID ausgewählt werden, aber nicht beides. Die Auswahl nach Anwendung instance ID wird im Allgemeinen bevorzugt, da Prozess-IDs nach Dem Beenden eines Prozesses möglicherweise wiederverwendet werden. Die Auswahl nach Prozess-ID kann jedoch nützlich sein, wenn Sie die Prozess-ID von einer anderen Quelle abrufen, z. B. ein Befehlszeilenargument für Ihr Programm.

Sie können eine oder alle für die Komponente verfügbaren Informationen anfordern, indem Sie Werte ohne NULL für Summary, Statistics oder HangMonitorInfo übergeben. Mindestens einer dieser Parameter muss nicht NULL sein.

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

Freigeben über