IGetAppTrackerData::GetApplicationsInProcess-Methode (comsvcs.h)

Artikel
08/22/2023

Ruft Zusammenfassungsinformationen für alle COM+-Anwendungen ab, die in einem einzelnen Prozess gehostet werden, oder für eine angegebene Teilmenge dieser Anwendungen.

Syntax

HRESULT GetApplicationsInProcess(
  [in]  REFGUID            ApplicationInstanceId,
  [in]  DWORD              ProcessId,
  [in]  REFGUID            PartitionId,
  [in]  DWORD              Flags,
  [out] ULONG              *NumApplicationsInProcess,
  [out] ApplicationSummary **Applications
);

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] PartitionId

Eine Partitions-ID zum Filtern von Ergebnissen oder GUID_NULL für alle Partitionen.

[in] Flags

Eine Kombination von Flags aus der GetAppTrackerDataFlags-Enumeration zum Filtern von Ergebnissen und zum Auswählen der zurückgegebenen Daten. Die folgenden Flags werden unterstützt: GATD_INCLUDE_LIBRARY_APPS, GATD_INCLUDE_SWC, GATD_INCLUDE_APPLICATION_NAME. Weitere Informationen finden Sie unter Hinweise unten.

[out] NumApplicationsInProcess

Bei der Rückgabe die Anzahl der Anwendungen im Prozess, die den filterkriterien entsprechen, die durch PartitionId und Flags angegeben sind.

[out] Applications

Bei der Rückgabe ein Array von ApplicationSummary-Strukturen für die übereinstimmenden Anwendungen.

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, und die Ergebnisse befinden sich im Applications-Parameter .
S_FALSE	Die Methode wurde erfolgreich abgeschlossen, aber es gab keine Prozesse, die den Filterkriterien entsprachen.
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 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.

Wenn weder GATD_INCLUDE_LIBRARY_APPS noch GATD_INCLUDE_SWC in Flags festgelegt sind, ist nur die COM+-Serveranwendung in den Ergebnissen enthalten. Wenn GATD_INCLUDE_LIBRARY_APPS festgelegt ist, sind auch COM+-Bibliotheksanwendungen im Prozess enthalten, sofern vorhanden. Wenn GATD_INCLUDE_SWC festgelegt ist und der Prozess mindestens einen Kontext für Dienste ohne Komponenten hostet, enthalten die Ergebnisse auch einen einzelnen Pseudoanwendungseintrag mit einer Zusammenfassung der SWC-Kontexte.

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

Share via