CatalogManager3.Initialize Method (PIA)

Use this method to initialize a CatalogManager object. This method should be called once before calling any other methods or properties.

[Visual Basic .NET]

Imports Microsoft.CommerceServer.Interop.Catalog
…
Public Sub Initialize(strConfigString As String,
  Optional fIsADOConnectionString As Boolean)

[C#]

using Microsoft.CommerceServer.Interop.Catalog;
…
public void Initialize(stringstrConfigString,
  boolfIsADOConnectionString);

[Visual Basic .NET]

strConfigString
A String that contains the configuration string.
fIsADOConnectionString
A Boolean that determines whether the strConfigString parameter refers to an ADO connection string or a site name. A value of True indicates an ADO connection string. A value of False indicates a site name. The default is False.

[C#]

strConfigString
A string that contains the configuration string.
fIsADOConnectionString
A bool that determines whether the strConfigString parameter refers to an ActiveX Data Object (ADO) connection string or a site name. A value of True indicates an ADO connection string. A value of False indicates a site name.

This method may throw one of many mapped exceptions or an exception of type COMException. See Standard COM Errors for additional details.

The following table shows the custom COM errors that a COMException can wrap.

Constant	Value	Description
`E_CAT_CATMGR_ALREADY_INITIALIZED`	[C#] 0x88980062 [Visual Basic .NET] &H88980062	The CatalogManager object has already been initialized. Each catalog manager object can be initialized only once.
`E_CAT_INVALID_PARAMETER`	[C#] 0x889800B6 [Visual Basic .NET] &H889800B6	The input parameter <parameter number> is invalid
`E_CAT_INVALID_NUMFULLTEXT_CATALOGS`	[C#] 0x889800E8 [Visual Basic .NET] &H889800E8	The number of fulltext catalogs to create should be between 0 and 256
`E_CAT_CATALOGRESOURCE_INIT_FAILED`	[C#] 0x88980030 [Visual Basic .NET] &H88980030	Unable to read the Product Catalog Resource from the site specified. Check that the Commerce.Adminhlpr component (Adminhlpr.dll) is registered, the site name is valid, and the site contains the Product Catalog Resource.
`E_CAT_INVALID_CATALOG_SCHEMA`	[C#] 0x889800D8 [Visual Basic .NET] &H889800D8	The Catalog Schema does not correspond to this version of Commerce Server 2002.

[Visual Basic .NET]

myCatalogManager.Initialize(strConfigString, True)

Namespace: Microsoft.CommerceServer.Interop.Catalog

Platforms: Windows 2000, Windows Server 2003

Assembly: cataloglib (in cataloglib.dll)

Additional resources