Description

Remove a category (flag) from this McDBCategories collection.

Return Type

None  

Syntax

object.Remove Description

The Remove Method syntax has these parts:

PartDescription
objectAn expression evaluating to an object of type McDBCategories.
DescriptionRequired. A String value.

The string name of the category to remove.

Remarks

Like Add, the effect of this method is context sensitive:
For McDBDatabase.Categories, the category is removed from the database,
    it will no longer be valid to add this category to any McDBType or
    McDBNode in the McDBDatabase.  It is not valid to remove a category
    that is associated with an McDBType or McDBNode.
For McDBType.Categories, the category is removed from the list of those
    automatically associated with new McDBNode instances created of the
    parent McDBType.  This operation has no effect on existing McDBNode
    instances, it only prevents the category from being automatically
    added to McDBNode instances created after this call.
For McDBNode.Categories, The category is removed from those associated
    with the McDBNode.

Exceptions

Error Value Description
E_FAIL &H80004005 The category named by Description does not exist in the database, or DBRoot was passed as Description.
E_INVALIDARG &H80070057 The category named by Description does not exist in this McDBCategories collection.
CO_E_ATTEMPT_TO_CREATE_OUTSIDE_CLIENT_CONTEXT &H80004024 The category named by Description is still being referenced by a McDBType.Attributes or McDBNode.Attributes collection. It may not be removed from the McDBDatabase.
E_UNEXPECTED &H8001FFFF A framework error occurred while modifying this McDBCategories collection.
E_ACCESSDENIED &H80070005 The McDBDatabase.LoggedUser does not have permission to write the McDBNode or McDBUser.ObjectTypeAdminRight privileges (when Remove is called on an McDBType).

Notes

The category DBRoot is defined by McDBLib and is never a valid parameter to Remove. Removing a category from an McDBType or McDBNode does not remove it from the McDBDatabase, even if there are no longer any objects referencing it (i.e. the category will remain valid for addition to McDBNode or McDBType instances).