Share via

IGetAppTrackerData::GetApplicationProcessDetails-Methode (comsvcs.h)

  • Artikel

Ruft detaillierte Informationen zu einem einzelnen Prozess ab, der COM+-Anwendungen hostet.

Syntax

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
);

Parameter

[in] ApplicationInstanceId

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

[in] ProcessId

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

[in] Flags

Eine Kombination von Flags aus der GetAppTrackerDataFlags-Enumeration , die angibt, welche Daten zurückgegeben werden sollen. Die folgenden Flags werden unterstützt: GATD_INCLUDE_PROCESS_EXE_NAME (beim Abrufen einer Zusammenfassung).

[out, optional] Summary

Bei der Rückgabe wird eine ApplicationProcessSummary-Struktur mit Zusammenfassungsinformationen für den Prozess angezeigt. Dieser Parameter kann NULL sein.

[out, optional] Statistics

Bei der Rückgabe eine ApplicationProcessStatistics-Struktur mit Statistiken für den Prozess. Dieser Parameter kann NULL sein.

[out, optional] RecycleInfo

Bei der Rückgabe eine ApplicationProcessRecycleInfo-Struktur mit Recyclingdetails für den Prozess. Dieser Parameter kann NULL sein.

[out, optional] AnyComponentsHangMonitored

Gibt bei der Rückgabe an, ob Komponenten im Prozess für die Überwachung des Hängenbleibens konfiguriert sind. 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.

Hinweise

Ein Prozess kann von seiner Anwendung instance-ID oder seiner Prozess-ID ausgewählt werden, aber nicht von beiden. Die Auswahl nach Anwendung instance ID wird im Allgemeinen bevorzugt, da Prozess-IDs nach Beendigung eines Prozesses wiederverwendet werden können. Die Auswahl nach Prozess-ID kann jedoch hilfreich sein, wenn Sie die Prozess-ID aus einer anderen Quelle abrufen, z. B. aus einem Befehlszeilenargument für Ihr Programm.

Sie können alle für den Prozess verfügbaren Informationen anfordern, indem Sie werte ungleich NULL für Summary, Statistics, RecycleInfo oder AnyComponentsHangMonitored übergeben. Mindestens einer dieser Parameter muss nicht NULL sein.

Anforderungen

Anforderung Wert
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