Catalog Property (SQL-DMO)

The Catalog property specifies the default or initial catalog for the referenced OLE DB data source definition.

Applies To

Syntax

object.Catalog [= value]

Part	Description
object	Expression that evaluates to an object in the Applies To list
value	String specifying a data source catalog

Remarks

The Catalog property provides a value for the OLE DB DBPROP_INIT_CATALOG initialization property when a connection is attempted to the data source referenced by the LinkedServer object. For more information about values for the Catalog property, see your OLE DB provider documentation.

Data Type

String

Modifiable

Read/write

Prototype (C/C++)

HRESULT GetCatalog(SQLDMO_LPBSTR pRetVal);

HRESULT SetCatalog(SQLDMO_LPCSTR NewVal);

Note SQL-DMO strings are always returned as OLE BSTR objects. A C/C++ application obtains a reference to the string. The application must release the reference by using SysFreeString.