Share via

ComponentSummary-Struktur (comsvcs.h)

  • Artikel

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

Weitere Informationen

IGetAppTrackerData