ICOMAdminCatalog2::GetCollectionByQuery2 method (comadmin.h)

Retrieves a collection of items in the COM+ catalog that satisfy the specified set of query keys.

Syntax

HRESULT GetCollectionByQuery2(
  [in]          BSTR      bstrCollectionName,
  [in]          VARIANT   *pVarQueryStrings,
  [out, retval] IDispatch **ppCatalogCollection
);

Parameters

[in] bstrCollectionName

The name of the collection to be retrieved from the catalog. Possible collection names can be found in the table of collections at COM+ Administration Collections.

[in] pVarQueryStrings

The query keys.

[out, retval] ppCatalogCollection

A pointer to an ICatalogCollection interface pointer containing the result of the query.

Return value

This method can return the standard return values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, E_FAIL, and S_OK.

Requirements

Requirement Value
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header comadmin.h

See also

ICOMAdminCatalog2