CatalogManager3.CategoryDefinitions Property (PIA)

Article
11/12/2009

The CategoryDefinitions property is a read-only Recordset that contains the names of all the category definitions in the Product Catalog System.

Definition

[Visual Basic .NET]

Imports Microsoft.CommerceServer.Interop.Catalog
Imports ADODB26Lib     ‘ for _Recordset
…
Public ReadOnly Property CategoryDefinitions As _Recordset

[C#]

using Microsoft.CommerceServer.Interop.Catalog;
using ADODB26Lib;                              //For _Recordset
…
public _Recordset CategoryDefinitions {get;}

[C#]

Property Value

An ADODB26Lib._Recordset interface to a Recordset object containing category definitions.

Exceptions

This property 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.

Name	Value	Description
E_CAT_CATMGR_NOT_INITIALIZED	[C#] 0x889800B [Visual Basic .NET] &H8898005	The CatalogManager object has not been initialized. The CatalogManager object should be initialized before calling this method.
E_CAT_INVALID_RS_POINTER	[C#] 0x889800B [Visual Basic .NET] &H8898007	The recordset pointer that you specified is invalid

E_CAT_CATMGR_NOT_INITIALIZED

[C#] 0x889800B

[Visual Basic .NET] &H8898005

The CatalogManager object has not been initialized. The CatalogManager object should be initialized before calling this method.

E_CAT_INVALID_RS_POINTER

[C#] 0x889800B

[Visual Basic .NET] &H8898007

The recordset pointer that you specified is invalid

Remarks

[Visual Basic .NET] The recordset returned by this property is valid only if it is accessed successfully.

[C#] The CategoryDefinitions parameter contains valid data only if the property was accessed successfully.

The returned Recordset will contain a single field called DefinitionName and one row for each category definition in the Product Catalog System. This field is a 128-character String.

If no category definitions are currently in the Product Catalog System, then the EOF property of the returned Recordset will be set to True.

Requirements

Namespace: Microsoft.CommerceServer.Interop.Catalog

Platforms: Windows 2000, Windows Server 2003

Assembly: cataloglib (in cataloglib.dll)