Classe COMAdminCatalogCollection
Representa qualquer coleção no catálogo COM+. Use-o para enumerar, adicionar, remover e recuperar itens em uma coleção e acessar coleções relacionadas.
Quando implementar
Essa classe é implementada pelo COM+.
| Requisito | Valor |
|---|---|
| Interfaces | ICatalogCollection |
Quando usar
Use objetos criados a partir da classe COMAdminCatalogCollection quando quiser manipular programaticamente uma coleção no catálogo COM+. Essas coleções correspondem a pastas na ferramenta de administração dos Serviços de Componentes. Os itens dentro das pastas correspondem a itens em coleções, que você pode representar usando objetos criados a partir da classe COMAdminCatalogObject .
Para obter informações sobre as coleções no catálogo e suas propriedades, consulte Coleções de Administração COM+.
Para obter uma introdução à administração programática do COM+, consulte Automatizando a administração com+.
Comentários
Você não pode criar diretamente um objeto COMAdminCatalogCollection . Para usar os métodos desse objeto, você deve criar um objeto COMAdminCatalog , obter uma referência a ICOMAdminCatalog e, em seguida, usar ICOMAdminCatalog::GetCollection para obter uma referência a uma interface ICatalogCollection que representa uma coleção de nível superior. Isso é mostrado no exemplo a seguir, em que "TopCollection" deve ser substituído pelo nome de uma das coleções de administração COM+ de nível superior.
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.
Para usar essa classe do Microsoft Visual Basic, adicione uma referência à Biblioteca de Tipos de Administração COM+. Um objeto COMAdminCatalogCollection pode ser criado chamando GetCollection em um objeto COMAdminCatalog . Isso é mostrado no exemplo a seguir, em que "TopCollection" deve ser substituído pelo nome de uma das coleções de administração COM+ de nível superior.
Dim objCatalog As COMAdmin.COMAdminCatalog
Set objCatalog = CreateObject("COMAdmin.COMAdminCatalog")
Dim objTopCollection As COMAdmin.COMAdminCatalogCollection
Set objTopCollection = objCatalog.GetCollection("TopCollection")
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte |
Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte |
Windows 2000 Server [somente aplicativos da área de trabalho] |
| Cabeçalho |
|
| IDL |
|