Platform SDK: Transaction Server

ICatalogCollection::GetCollection

[This product will work only on Windows NT 4.0 versions and earlier. For Windows 2000 and later, see COM+ (Component Services).]

The GetCollection method retrieves a collection related to a specific object. Data is not read from the catalog. See the Populate method topic for more information.

HRESULT ICatalogCollection::GetCollection(
BSTR
bstrCollName
VARIANT
varObjectKey
IDispatch **
ppCatalogCollection);

Parameters

bstrCollName [in]
BSTR containing the name of the collection.

VarObjectKey [in]
Value of the object key.

retval [out]
Pointer to a pointer to the CatalogCollection object.

Return Values

S_OK
Method completed successfully.

E_INVALIDARG
Invalid collection name passed as a parameter. Can also indicate that an Out parameter is NULL.

Remarks

See the Using MTS Collections topic for a list of the MTS collections and their properties.