[<<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