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