Classe COMAdminCatalogCollection

Représente n’importe quelle collection dans le catalogue COM+. Utilisez-la pour énumérer, ajouter, supprimer et récupérer des éléments d’une collection et accéder aux collections associées.

Quand implémenter

Cette classe est implémentée par COM+.

Condition requise	Valeur
Interfaces	ICatalogCollection

Quand l’utiliser

Utilisez des objets créés à partir de la classe COMAdminCatalogCollection lorsque vous souhaitez manipuler par programmation une collection dans le catalogue COM+. Ces collections correspondent à des dossiers dans l’outil d’administration Services de composants. Les éléments contenus dans les dossiers correspondent aux éléments des collections, que vous pouvez représenter à l’aide d’objets créés à partir de la classe COMAdminCatalogObject .

Pour plus d’informations sur les collections du catalogue et leurs propriétés, consultez Collections d’administration COM+.

Pour une présentation de l’administration par programmation de COM+, consultez Automatisation de l’administration COM+.

Notes

Vous ne pouvez pas créer directement un objet COMAdminCatalogCollection . Pour utiliser les méthodes de cet objet, vous devez créer un objet COMAdminCatalog , obtenir une référence à ICOMAdminCatalog, puis utiliser ICOMAdminCatalog::GetCollection pour obtenir une référence à une interface ICatalogCollection qui représente une collection de niveau supérieur. Cela est illustré dans l’exemple suivant, où « TopCollection » doit être remplacé par le nom de l’une des collections d’administration COM+ de niveau supérieur.

    HRESULT hr = CoCreateInstance(CLSID_COMAdminCatalog, NULL, 
      CLSCTX_INPROC_SERVER, IID_IUnknown, (void**)&pUnknown);
    if (FAILED (hr)) exit(0);  // Replace with specific error handling.
    hr = pUnknown->QueryInterface(IID_ICOMAdminCatalog, 
      (void**)&pCatalog); 
    if (FAILED (hr)) exit(0);  // Replace with specific error handling.
    hr = pCatalog->GetCollection(L"TopCollection", 
      (IDispatch**)&pTopColl);
    if (FAILED (hr)) exit(0);  // Replace with specific error handling.

Pour utiliser cette classe à partir de Microsoft Visual Basic, ajoutez une référence à la bibliothèque de types COM+ Administration. Un objet COMAdminCatalogCollection peut être créé en appelant GetCollection sur un objet COMAdminCatalog . Cela est illustré dans l’exemple suivant, où « TopCollection » doit être remplacé par le nom de l’une des collections d’administration COM+ de niveau supérieur.

Dim objCatalog As COMAdmin.COMAdminCatalog
Set objCatalog = CreateObject("COMAdmin.COMAdminCatalog")
Dim objTopCollection As COMAdmin.COMAdminCatalogCollection
Set objTopCollection = objCatalog.GetCollection("TopCollection")

Spécifications

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]
En-tête	ComAdmin.h
IDL	ComAdmin.Idl

Voir aussi

COMAdminCatalog

COMAdminCatalogObject

ICatalogCollection