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);
Propriétés
| Type | Visibilité | Source | Unité | Parent |
|---|---|---|---|---|
| function | public | Vcl.CmAdmCtl.pas Vcl.CmAdmCtl.hpp |
Vcl.CmAdmCtl | TCOMAdminCatalog |
Description
Récupère une collection du catalogue COM+, à partir de tous ses éléments parents.
Appelez GetCollectionByQuery pour obtenir une collection du catalogue en fonction de la propriété Key de chacun de ses éléments parents. Cette propriété est un GUID qui identifie chaque élément parent de façon unique dans le catalogue COM+.
bstrCollName correspond au nom de la collection souhaitée. Les collections disponibles dépendent de votre version de la bibliothèque COMAdmin. Pour obtenir une liste de toutes les collections disponibles dans votre version de la bibliothèque COMAdmin, consultez la documentation Microsoft.
aQuery est un tableau sécurisé contenant la propriété Key de chaque élément parent de la collection souhaitée.
Remarque : Si bstrCollName a la valeur ‘ErrorInfo', ‘RelatedCollectionInfo’ ou ‘PropertyInfo', GetCollectionByQuery ignore le paramètre aQuery et renvoie immédiatement la collection nommée par rapport à la collection Root. Pour obtenir ces collections en fonction d'une collection arbitraire du catalogue, utilisez la méthode GetCollection de la collection parent.
Remarque : L'objet TCOMAdminCatalogCollection renvoyé par GetCollectionByQuery ne contient aucune donnée du catalogue des éléments contenus dans la collection. Utilisez la méthode Populate pour lire les données des éléments de la collection.