Share via

ICOMAdminCatalog::GetCollectionByQuery-Methode (comadmin.h)

  • Artikel

Ruft eine Auflistung im COM+-Katalog unter Berücksichtigung der Schlüsseleigenschaftenwerte für alle übergeordneten Elemente ab.

Syntax

HRESULT GetCollectionByQuery(
  [in]          BSTR      bstrCollName,
  [in]          SAFEARRAY **ppsaVarQuery,
  [out, retval] IDispatch **ppCatalogCollection
);

Parameter

[in] bstrCollName

Der Name der abzurufenden Auflistung.

[in] ppsaVarQuery

Ein Verweis auf ein Array, das aus Schlüsseleigenschaftenwerten für alle übergeordneten Elemente der Sammlung besteht, die abgerufen werden sollen.

[out, retval] ppCatalogCollection

Die ICatalogCollection-Schnittstelle für die Auflistung.

Rückgabewert

Diese Methode kann die Standardrückgabewerte E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL und S_OK zurückgeben.

Hinweise

Der ICatalogObject::Key-Eigenschaftswert für ein Element ist eine GUID, die dazu dient, es im COM+-Katalog eindeutig zu identifizieren.

Die GetCollectionByQuery-Methode ruft jede Auflistung im Katalog ab, wobei die Schlüsselwerte für alle übergeordneten Elemente angegeben sind. Bei den Auflistungen ErrorInfo, PropertyInfo und RelatedCollectionInfo verhält sich diese Methode jedoch anders. Wenn Sie eine dieser Auflistungen angeben, gibt GetCollectionByQuery immer diese benannte Auflistung sofort relativ zur Root-Auflistung zurück.

Um die ErrorInfo-, PropertyInfo- oder RelatedCollectionInfo-Auflistung abzurufen, die relativ zu einer beliebigen Auflistung im Katalog und nicht relativ zur Root-Auflistung ist, verwenden Sie die GetCollection-Methode aus der übergeordneten Auflistung.

Eine vollständige Liste der verfügbaren Sammlungen finden Sie unter COM+-Verwaltungssammlungen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile comadmin.h

Weitere Informationen

ICOMAdminCatalog