Vcl.CmAdmCtl.TCOMAdminCatalog.GetCollectionByQuery
Delphi
function GetCollectionByQuery(const bstrCollName: WideString; var aQuery: PSafeArray):
C++
TCOMAdminCatalogCollection* __fastcall GetCollectionByQuery(const System::WideString bstrCollName, Winapi::Activex::PSafeArray &aQuery);
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | Vcl.CmAdmCtl.pas Vcl.CmAdmCtl.hpp |
Vcl.CmAdmCtl | TCOMAdminCatalog |
Beschreibung
Gibt anhand der übergeordneten Elemente eine Kollektion aus dem COM+ Katalog zurück.
Mit GetCollectionByQuery können Sie eine Kollektion anhand der Eigenschaft Key der übergeordneten Elemente aus dem COM+ Katalog abrufen. Diese Eigenschaft enthält eine GUID, die das jeweilige Element im Katalog eindeutig bezeichnet.
bstrCollName gibt den Namen der gewünschten Kollektion an. Welche Kollektionen verfügbar sind, hängt von der Version der verwendeten COMAdmin-Bibliothek ab. Eine Liste der Kollektionen Ihrer Bibliotheksversion finden Sie in der Microsoft-Dokumentation.
aQuery ist ein Array, das die Eigenschaft Key jedes übergeordneten Elements von bstrCollName enthält.
Anmerkung: Wenn bstrCollName den Wert ErrorInfo, RelatedCollectionInfo oder PropertyInfo hat, ignoriert die Methode GetCollectionByQuery den Parameter aQuery und gibt die Kollektion relativ zur Stammkollektion zurück. Wenn Sie Kollektionen relativ zu einer beliebigen Kollektion im Katalog abrufen möchten, verwenden Sie die Methode GetCollection der übergeordneten Kollektion.
Anmerkung: Das von GetCollectionByQuery zurückgegebene TCOMAdminCatalogCollection-Objekt enthält keine Katalogdaten für die Elemente der Kollektion. Diese Informationen können mit der Methode Populate eingelesen werden.