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 |