[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 childEnd()
 Report end of relation
------------------------------------------------------------------------------
 Prototype

     ERRCODE childEnd(
                          AREAP wa,
                          LPDBRELINFO lpdbRelInfo
                       )

 Arguments

     wa is a pointer to self.

     lpdbRelInfo is a pointer to a structure containing information on a
     relation.

 Description

     childEnd() indicates that one of wa's parent work areas is no longer related.

 Default Behavior

     childEnd() indicates that the referenced work area is related to one less
     parent by decrementing wa->uiParents.  This method does not physically
     unhook a child from a parent.

     Warning!  There is no check to guarantee that wa->uiParents will
     wrap from 0 to 255 after the decrement.

 Implementation Notes

     .  If your RDD supports relations, ensure that the child work area
        (denoted by wa) does not have a pending relational move that relies
        upon the existence of the parent referenced by lpdbRelInfo.  If such
        a movement exists, it must be resolved by a call to SELF_FORCEREL()
        prior to removal.

     .  In most driver implementations, parent-child relations will be
        stored exclusively in the parent work area.  clearRel() removes all
        child relations from a parent; there is no way to remove a single
        relation from a parent's relation list using the CA-Clipper DML.

 Files  Header file is Rdd.api.


See Also: AREA DBRELINFO childStart() clearRel()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson