ProductCatalog.RootCategories
.gif "Ee823560.c++_on(en-US,CS.10).gif")
.gif "Ee823560.vb_off(en-US,CS.10).gif")
The RootCategories property is a read-only recordset that contains the names of the categories that exist at the root level of this catalog.
Definition
Property RootCategories(Optional vrPropertiesRequired As Variant) As _Recordset
Parameters
vrPropertiesRequired
A VARIANT, subtype String, that contains a comma-separated list of the required property names.
Error Values
This method sets the Number property of the global Err object to S_OK (&H00000000) to indicate success and to standard COM error values to indicate failure. For more information about standard COM errors, see Standard COM Errors. Additional information may be available using the global Err object. In particular, the Description property may contain a text description of the error.
Remarks
Any category without parents is considered to be a root category.
The Recordset object returned by this method will contain one row for each root category, and a field for each property name in the vrPropertiesRequired parameter. If the parameter is omitted, the Recordset object will contain all of the corresponding fields. For more information about these fields, see CatalogProduct Recordset.
.gif "Ee823560.note(en-US,CS.10).gif")
Note
- Leading numbers in the property names in the vrPropertiesRequired parameter will be trimmed from the corresponding field names in the returned recordset. The data will be correct; only the field names will be incorrect. If the property is omitted, then the field names will be correct. Enclose field names that begin with a number in brackets to avoid this problem. For example,
oProductCatalog.RootCategories("[123_Prop1],[123_ Prop2]").
For more information about memory ownership issues related to COM property and method parameters, see Managing COM Parameter Memory.