Synopsis

PDX_MSGT mda_DeepDeleteEntity(long option, MDA_PTR db_ptr)

Purpose

Delete the entity passed in and all of its descendants

Description

This function will delete an entity corresponding to db_ptr and recursively delete all of this entity's descendants. If any of these descendants have more than one parent then that descendant and all it's descendants will not be deleted since it is referenced by another entity. If the entity corresponding to the database pointer passed in has more than one parent the entity and its descendants will not be deleted unless MDA_FORCE_DELETE is the specified option. If this option is specified, all references between the entity and it's parents will be deleted. The entity's descendants will then be deleted unless they have more than one parent. In the case where the entity corresponding to db_ptr has multiple parents and MDA_FORCE_DELETE is not specified it is up to the application to delete the references between the entity and the proper parent if this is desirable.

Input

option

MDA_FORCE_DELETE Delete the entity regardless of whether or not it has multiple parents. MDA_FORCE_DEEP_DELETE Delete the entity regardless of anything

db_ptr

Database pointer of the entity to be deleted.

Return

MDA error code