company logo

Property :: validateForParent - Is property handle still valid for parent

The function checks, whether the property handle is still valid for the parent property handle passed in rProperty, i.e. whether the property is a direct sub-property of the parent. Since parents may move for transient or weak-typed properties, the application has to check in case of subordinated property handles, whether those are still valid or not.

When the property handle is not valid anymore for the parent property handle, it might be reopened automatically. Before reopening the property handle, it will be closed, i.e. the current cursor will be released. When passing true for bReopen, the property handle reopens the current property handle for the new parent.

The function throws an error, when reopening fails.

Implementation details

Property  :: validateForParent ( odaba::Property &cProperty, bool bReopen )
  • cProperty - Property reference

    A property handle refers to a (usually) opened property. Invalid properties may cause an exception.

  • bReopen - Reopen option

    The parameter indicates, whether the handle should be reopened automatically.