Метод 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 для элемента — это GUID, который служит для его уникальной идентификации в каталоге COM+.

Метод GetCollectionByQuery извлекает любую коллекцию в каталоге с учетом значений ключей для всех его родительских элементов. Однако в коллекциях ErrorInfo, PropertyInfo и RelatedCollectionInfo этот метод ведет себя по-разному. Если вы укажете любую из этих коллекций, GetCollectionByQuery всегда возвращает эту именованную коллекцию сразу же относительно корневой коллекции.

Чтобы получить коллекцию ErrorInfo, PropertyInfo или RelatedCollectionInfo , которая относится к произвольной коллекции в каталоге, а не относительно корневой коллекции, используйте метод GetCollection из родительской коллекции.

Полный список доступных коллекций см. в разделе Коллекции администрирования COM+.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	comadmin.h

См. также раздел

ICOMAdminCatalog