Classe COMAdminCatalogCollection

Rappresenta qualsiasi raccolta nel catalogo COM+. Usarlo per enumerare, aggiungere, rimuovere e recuperare elementi in una raccolta e accedere alle raccolte correlate.

Quando implementare

Questa classe viene implementata da COM+.

Requisito	Valore
Interfacce	ICatalogCollection

Utilizzo

Usare gli oggetti creati dalla classe COMAdminCatalogCollection quando si vuole modificare a livello di codice una raccolta nel catalogo COM+. Queste raccolte corrispondono alle cartelle nello strumento di amministrazione di Servizi componenti. Gli elementi all'interno delle cartelle corrispondono agli elementi nelle raccolte, che è possibile rappresentare usando oggetti creati dalla classe COMAdminCatalogObject .

Per informazioni sulle raccolte nel catalogo e sulle relative proprietà, vedere Raccolte di amministrazione COM+.

Per un'introduzione all'amministrazione a livello di codice di COM+, vedere Automazione dell'amministrazione COM+ .

Commenti

Non è possibile creare direttamente un oggetto COMAdminCatalogCollection . Per usare i metodi di questo oggetto, è necessario creare un oggetto COMAdminCatalog, ottenere un riferimento a ICOMAdminCatalog e quindi usare ICOMAdminCatalog::GetCollection per ottenere un riferimento a un'interfaccia ICatalogCollection che rappresenta un insieme di livello superiore. Questo è illustrato nell'esempio seguente, dove "TopCollection" deve essere sostituito dal nome di una delle raccolte di amministrazione COM+ di primo livello.

    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.

Per usare questa classe da Microsoft Visual Basic, aggiungere un riferimento alla libreria di tipi COM+ Amministrazione. È possibile creare un oggetto COMAdminCatalogCollection chiamando GetCollection in un oggetto COMAdminCatalog. Questo è illustrato nell'esempio seguente, dove "TopCollection" deve essere sostituito dal nome di una delle raccolte di amministrazione COM+ di primo livello.

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Intestazione	ComAdmin.h
IDL	ComAdmin.Idl

Vedi anche

COMAdminCatalog

COMAdminCatalogObject

ICatalogCollection