Share via


Category3.ParentCategories Property (PIA)

The ParentCategories property is a read-only recordset that contains the names of the parent categories of this category.

Definition

[Visual Basic .NET]

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

[C#]

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

[C#]

Property Value

An ADODB26Lib._Recordset interface to a Recordset object containing the parent categories.

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.

Constant Value Description
E_CAT_INVALID_RS_POINTER

[C#] 0x889800B7

[Visual Basic .NET] &H889800B7

The recordset pointer that you specified is invalid

Remarks

[Visual Basic .NET]

The ParentCategories property contains valid data only if the property is accessed successfully.

The ParentCategories property contains the names of the categories that are parent categories of this category. The recordset returned contains a 128-character string column, called Name, and one row for each parent that exists.

The returned recordset contains the fields listed in the following table.

Field Data Type Description
Name String
Maximum of 128 characters
Name of the parent category.
DisplayName String
Maximum of 128 characters
Display name of the category.
FVirtualCatalog bit For a virtual catalog this field specifies if this link was inherited(value 0) or explicitly added (value 1). For a base catalog this field will always be 0.

If this category is a root category, it has no parent categories, and an empty recordset is returned whose EOF property is set to VARIANT_TRUE.

Requirements

Namespace: Microsoft.CommerceServer.Interop.Catalog

Platforms: Windows 2000, Windows Server 2003

Assembly: cataloglib (in cataloglib.dll)

See Also

Category Class

Category3.AncestorCategories

Category3.ChildCategories

Copyright © 2005 Microsoft Corporation.
All rights reserved.