ICatalogCollection::GetCollection method (comadmin.h)

Retrieves a collection from the COM+ catalog that is related to the current collection.

Syntax

HRESULT GetCollection(
  [in]          BSTR      bstrCollName,
  [in]          VARIANT   varObjectKey,
  [out, retval] IDispatch **ppCatalogCollection
);

Parameters

[in] bstrCollName

The name of the collection to be retrieved.

[in] varObjectKey

The Key property value of the parent item of the collection to be retrieved.

[out, retval] ppCatalogCollection

The ICatalogCollection interface for the retrieved collection.

Return value

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

Remarks

This method does not read in data for items in the retrieved collection from the catalog data store. Use the Populate method to read in data for items in the collection.

Requirements

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

See also

ICatalogCollection