IGetAppTrackerData::GetApplicationProcessDetails-Methode (comsvcs.h)
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 |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
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 |