Request_Delete - BaseData_Set
Responsible for deleting a record in the DDO for the main_file, updating all parent DDOs (and tables) and possibly deleting all child records
Type: Procedure
Syntax
Procedure Request_Delete
Call Example
Send Request_Delete
Description
The Request_Delete message is responsible for deleting a record in the DDO for the main_file, updating all parent DDOs (and tables) and possibly deleting all child records.
Two modes of deleting are supported: A delete will delete all related descendant records.A deletes will not be allowed when child records exist. The property Cascade_Delete_State controls this message.
Request_Delete will return the handled error 4527 - DFERR_CANT_REFIND_RECORD when records cannot be refound/reread. The intent is to notify the user that someone must have deleted this record since it was last found by the user and that this is not a bug, but normal multi-user behavior when one user deleted a record that another user has pulled up in a view, etc.
Request_Delete is not re-entrant. Once a major Data-Dictionary operation (save, find, delete, clear) has begun you cannot start another major operation. The reentrancy restriction applies within DDO structures and across DDO structures.
See Also