Platform SDK: Transaction Server

ICatalog::Connect

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

The Connect method connects to a remote computer and returns a root collection, which is bound to a remote computer.

HRESULT ICatalog::Connect(
BSTR
bstrConnectString
IDispatch **
ppCatalogCollection);

Parameters

bstrConnectString [in]
BSTR expression containing the name of a remote computer.

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

Return Values

S_OK
Method completed successfully.

E_INVALIDARG
Out parameter is NULL.

Comments

A root collection serves as a starting point to locate packages, and contains neither objects nor properties. Note that you can also use the GetCollection method to get a top-level collection on a local server without using the Connect method.