다음을 통해 공유

ICOMAdminCatalog::GetCollectionByQuery 메서드(comadmin.h)

  • 아티클

모든 부모 항목에 대한 키 속성 값이 지정된 경우 COM+ 카탈로그에서 컬렉션을 검색합니다.

구문

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

매개 변수

[in] bstrCollName

검색할 컬렉션의 이름입니다.

[in] ppsaVarQuery

검색할 컬렉션의 모든 부모 항목에 대한 키 속성 값으로 구성된 배열에 대한 참조입니다.

[out, retval] ppCatalogCollection

컬렉션에 대한 ICatalogCollection 인터페이스입니다.

반환 값

이 메서드는 표준 반환 값 E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL 및 S_OK 반환할 수 있습니다.

설명

항목에 대한 ICatalogObject::Key 속성 값은 COM+ 카탈로그에서 고유하게 식별하는 데 사용되는 GUID입니다.

GetCollectionByQuery 메서드는 모든 부모 항목에 대한 키 값을 고려하여 카탈로그의 모든 컬렉션을 검색합니다. 그러나 ErrorInfo, PropertyInfo 및 RelatedCollectionInfo 컬렉션을 사용하면 이 메서드가 다르게 동작합니다. 이러한 컬렉션을 지정하는 경우 GetCollectionByQuery 는 항상 루트 컬렉션을 기준으로 명명된 컬렉션을 즉시 반환합니다.

루트 컬렉션을 기준으로 하지 않고 카탈로그의 임의 컬렉션을 기준으로 하는 ErrorInfo, PropertyInfo 또는 RelatedCollectionInfo 컬렉션을 얻으려면 부모 컬렉션에서 GetCollection 메서드를 사용합니다.

사용 가능한 컬렉션의 전체 목록은 COM+ 관리 컬렉션을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 comadmin.h

추가 정보

ICOMAdminCatalog