Méthode ICOMAdminCatalog ::GetCollectionByQuery (comadmin.h)

Récupère une collection sur le catalogue COM+ en fonction des valeurs de propriété de clé pour tous ses éléments parents.

Syntaxe

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

Paramètres

[in] bstrCollName

Nom de la collection à récupérer.

[in] ppsaVarQuery

Référence à un tableau constitué de valeurs de propriété de clé pour tous les éléments parents de la collection à récupérer.

[out, retval] ppCatalogCollection

Interface ICatalogCollection pour la collection.

Valeur retournée

Cette méthode peut retourner les valeurs de retour standard E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL et S_OK.

Remarques

La valeur de la propriété ICatalogObject ::Key pour un élément est un GUID qui sert à l’identifier de manière unique dans le catalogue COM+.

La méthode GetCollectionByQuery récupère n’importe quelle collection dans le catalogue, en fonction des valeurs de clé de tous ses éléments parents. Toutefois, avec les collections ErrorInfo, PropertyInfo et RelatedCollectionInfo , cette méthode se comporte différemment. Si vous spécifiez l’une de ces collections, GetCollectionByQuery retourne toujours cette collection nommée immédiatement par rapport à la collection Racine .

Pour obtenir la collection ErrorInfo, PropertyInfo ou RelatedCollectionInfo relative à une collection arbitraire dans le catalogue et non relative à la collection Root , utilisez la méthode GetCollection de la collection parente.

Pour obtenir la liste complète des collections disponibles, consultez Collections d’administration COM+.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	comadmin.h

Voir aussi

ICOMAdminCatalog