IGetAppTrackerData::GetComponentsInProcess-Methode (comsvcs.h)
Ruft Zusammenfassungsinformationen für alle COM+-Komponenten ab, die in einem einzelnen Prozess gehostet werden, oder für eine angegebene Teilmenge dieser Komponenten.
Syntax
HRESULT GetComponentsInProcess(
[in] REFGUID ApplicationInstanceId,
[in] DWORD ProcessId,
[in] REFGUID PartitionId,
[in] REFGUID ApplicationId,
[in] DWORD Flags,
[out] ULONG *NumComponentsInProcess,
[out] ComponentSummary **Components
);
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] PartitionId
Eine Partitions-ID zum Filtern von Ergebnissen oder GUID_NULL für alle Partitionen.
[in] ApplicationId
Eine Anwendungs-ID zum Filtern von Ergebnissen oder GUID_NULL für alle Anwendungen.
[in] Flags
Eine Kombination von Flags aus der GetAppTrackerDataFlags-Enumeration , um Ergebnisse zu filtern und auszuwählen, welche Daten zurückgegeben werden. Die folgenden Flags werden unterstützt: GATD_INCLUDE_LIBRARY_APPS, GATD_INCLUDE_SWC, GATD_INCLUDE_CLASS_NAME, GATD_INCLUDE_APPLICATION_NAME. Weitere Informationen finden Sie weiter unten unter Hinweise.
[out] NumComponentsInProcess
Bei der Rückgabe die Anzahl der Komponenten im Prozess, die den Filterkriterien entsprechen, die durch PartitionId, ApplicationId und Flags angegeben sind.
[out] Components
Bei der Rückgabe ein Array von ComponentSummary-Strukturen für die übereinstimmenden Komponenten.
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, und die Ergebnisse befinden sich im Components-Parameter . |
|
Die Methode wurde erfolgreich abgeschlossen, aber es gab keine Komponenten, die den Filterkriterien entsprachen. |
|
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.
Wenn weder GATD_INCLUDE_LIBRARY_APPS noch GATD_INCLUDE_SWC in Flags festgelegt sind, werden nur Komponenten aus der COM+-Serveranwendung in die Ergebnisse einbezogen. Wenn GATD_INCLUDE_LIBRARY_APPS festgelegt ist, werden ggf. auch Komponenten aus COM+-Bibliotheksanwendungen in den Prozess einbezogen. Wenn GATD_INCLUDE_SWC festgelegt ist, enthalten die Ergebnisse auch Einträge für Dienste ohne Komponentenkontexte.
Wenn ApplicationId verwendet wird, um eine Anwendung anzugeben (sie ist nicht auf GUID_NULL festgelegt), sind die Flags GATD_INCLUDE_LIBRARY_APPS und GATD_INCLUDE_SWC nicht aussagekräftig und dürfen nicht verwendet werden. Komponenten aus der angegebenen Anwendung werden unabhängig vom Typ dieser Anwendung zurückgegeben.
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 |