Category.AddChildCategory

Ee810899.c++_on(en-US,CS.10).gifEe810899.vb_off(en-US,CS.10).gif

Use this method to add a category as a child to this category.

Definition

Sub AddChildCategory(strCategoryName As String)

Parameters

strCategoryName

A String that contains the name of the category to be added as a child to this category.

Return Values

None.

Error Values

This method sets the Number property of the global Err object to S_OK (&H00000000) to indicate success and to either standard or custom COM error values to indicate failure. For more information about standard COM errors, see Standard COM Errors.

The following table shows the custom COM errors that this method can return.

Constant Value Description
E_CAT_CATEGORY_ALREADY_ADDED &H8898002D The specified category has already been added as child to this category.
E_CAT_CATEGORY_DOESNT_EXIST &H8898001C The specified category did not exist.
E_CAT_INVALID_CHILDCATEGORY &H8898005D The category that you specified already exists as a parent of this category.
E_CAT_INVALID_RELATION &H88980039 A category cannot be a parent or child of itself.

Additional information may be available using the global Err object. In particular, the Description property may contain a text description of the error.

Remarks

For more information about memory ownership issues related to COM property and method parameters, see Managing COM Parameter Memory.

Example

myCategory.AddChildCategory "shirts"

See Also

Category Object

Category.AddParentCategory

Category.RemoveChildCategory


All rights reserved.