Método ICOMAdminCatalog::GetCollectionByQuery (comadmin.h)

Recupera una colección en el catálogo COM+ según los valores de propiedad de clave para todos sus elementos primarios.

Sintaxis

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

Parámetros

[in] bstrCollName

Nombre de la colección que se va a recuperar.

[in] ppsaVarQuery

Referencia a una matriz que consta de valores de propiedad de clave para todos los elementos primarios de la colección que se van a recuperar.

[out, retval] ppCatalogCollection

Interfaz ICatalogCollection de la colección.

Valor devuelto

Este método puede devolver los valores devueltos estándar E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL y S_OK.

Comentarios

El valor de la propiedad ICatalogObject::Key para un elemento es un GUID que sirve para identificarlo de forma única en el catálogo COM+.

El método GetCollectionByQuery recupera cualquier colección del catálogo, dados los valores de clave de todos sus elementos primarios. Sin embargo, con las colecciones ErrorInfo, PropertyInfo y RelatedCollectionInfo , este método se comporta de forma diferente. Si especifica alguna de estas colecciones, GetCollectionByQuery siempre devuelve esa colección con nombre inmediatamente con respecto a la colección Raíz .

Para obtener la colección ErrorInfo, PropertyInfo o RelatedCollectionInfo relativa a una colección arbitraria del catálogo y no relativa a la colección Root , use el método GetCollection de la colección primaria.

Para obtener una lista completa de las colecciones disponibles, consulte Colecciones de administración de COM+.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	comadmin.h

Consulte también

ICOMAdminCatalog