ICOMAdminCatalog::GetCollectionByQuery-Methode (comadmin.h)
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 |