COMAdminCatalogCollection 클래스

COM+ 카탈로그의 모든 컬렉션을 나타냅니다. 컬렉션의 항목을 열거, 추가, 제거 및 검색하고 관련 컬렉션에 액세스하는 데 사용합니다.

구현 시기

이 클래스는 COM+에서 구현됩니다.

요구 사항	값
인터페이스	ICatalogCollection

사용 시기

COM+ 카탈로그에서 컬렉션을 프로그래밍 방식으로 조작하려는 경우 COMAdminCatalogCollection 클래스에서 만든 개체를 사용합니다. 이러한 컬렉션은 Component Services 관리 도구의 폴더에 해당합니다. 폴더 내의 항목은 COMAdminCatalogObject 클래스에서 만든 개체를 사용하여 나타낼 수 있는 컬렉션의 항목에 해당합니다.

카탈로그의 컬렉션 및 해당 속성에 대한 자세한 내용은 COM+ 관리 컬렉션을 참조하세요.

COM+의 프로그래밍 방식 관리에 대한 소개는 COM+ 관리 자동화를 참조하세요.

설명

COMAdminCatalogCollection 개체를 직접 만들 수 없습니다. 이 개체 메서드를 사용하려면 COMAdminCatalog 개체를 만들고, ICOMAdminCatalog에 대한 참조를 가져온 다음, ICOMAdminCatalog::GetCollection 을 사용하여 최상위 컬렉션을 나타내는 ICatalogCollection 인터페이스에 대한 참조를 가져와야 합니다. 다음 예제에서는 "TopCollection"을 최상위 COM+ 관리 컬렉션 중 하나의 이름으로 바꿔야 합니다.

    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.

Microsoft Visual Basic에서 이 클래스를 사용하려면 COM+ 관리 형식 라이브러리에 대한 참조를 추가합니다. COMAdminCatalogCollection 개체에서 GetCollection 을 호출하여 COMAdminCatalogCollection 개체를 만들 수 있습니다. 다음 예제에서는 "TopCollection"을 최상위 COM+ 관리 컬렉션 중 하나의 이름으로 바꿔야 합니다.

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

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
헤더	ComAdmin.h
IDL	ComAdmin.Idl

추가 정보

COMAdminCatalog

COMAdminCatalogObject

ICatalogCollection