共用方式為

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 一律會傳回與 Root 集合相對的具名集合。

若要取得相對於目錄中任意集合的 ErrorInfo、 PropertyInfo 或 RelatedCollectionInfo 集合，而不是相對於 Root 集合，請使用父集合中的 GetCollection 方法。

如需可用集合的完整清單，請參閱 COM+ 系統管理集合。

規格需求

需求 值
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 comadmin.h

另請參閱

ICOMAdminCatalog