ComponentSummary-Struktur (comsvcs.h)
Stellt Zusammenfassungsinformationen zu einer COM+-Komponente dar, die in einem bestimmten Prozess gehostet wird. Sie kann auch einen SWC-Kontext (Services Without Components) darstellen.
Syntax
typedef struct _ComponentSummary {
GUID ApplicationInstanceId;
GUID PartitionId;
GUID ApplicationId;
CLSID Clsid;
LPWSTR ClassName;
LPWSTR ApplicationName;
} ComponentSummary;
Member
ApplicationInstanceId
Die Anwendung instance GUID, die den Prozess, der die Komponente hostet, eindeutig identifiziert.
PartitionId
Die Partitions-ID der Komponente.
ApplicationId
Die Anwendungs-ID der Komponente. Der Sonderwert {84ac4168-6fe5-4308-a2ed-03688a023c7a} gibt an, dass dies ein SWC-Kontext ist.
Clsid
Die CLSID der Komponente.
ClassName
Der Name der Komponente. In der Regel ist dies die ProgID der Komponente (oder die Zeichenfolgendarstellung der CLSID der Komponente, wenn die Komponente keine ProgID aufweist). Für SWC-Kontexte ist dies die Eigenschaft des Kontextnamens, die für den Kontext konfiguriert ist. Der Speicherplatz für diese Zeichenfolge wird von der Methode zugewiesen, die aufgerufen und vom Aufrufer freigegeben wird (weitere Informationen finden Sie unter CoTaskMemFree). Dieser Member wird standardmäßig nicht zurückgegeben. Um diesen Member zurückzugeben, geben Sie das flag GATD_INCLUDE_CLASS_NAME an, wenn Sie eine Methode aufrufen, die eine ComponentSummary-Struktur zurückgibt.
ApplicationName
Der Name der COM+-Anwendung oder die Für einen SWC-Kontext konfigurierte Eigenschaft des Anwendungsnamens. Der Speicherplatz für diese Zeichenfolge wird von der Methode zugewiesen, die aufgerufen und vom Aufrufer freigegeben wird (weitere Informationen finden Sie unter CoTaskMemFree). Dieser Member wird standardmäßig nicht zurückgegeben. Um diesen Member zurückzugeben, geben Sie das GATD_INCLUDE_APPLICATION_NAME-Flag an, wenn Sie eine Methode aufrufen, die eine ComponentSummary-Struktur zurückgibt.
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] |
| Kopfzeile | comsvcs.h |