company logo

PropertyHandle :: GetOrigin - Get original property handle

The function returns a pointer to the original property handle. For original property handles, i.e. property handles that are not copies of another property handle and that are not transient property handles, the function returns a pointer to the calling property handle. When the property handle has been created as cursor copy of another property handle, the function returns a pointer to the originating property handle, which differs from the calling object. For transient property handles this is the origin for the associated property handle.

The function returns NULL, when the handle is not opened or when no property handle is associated for a transient property.

  if ( &prop_hdl == prop_hdl.GetOrigin() )

    printf("Property handle is an original one");

Return value:  Pointer to property handle ( PropertyHandle * )

Is a pointer to an (usually) opened property handle.

Implementation details

PropertyHandle * PropertyHandle  :: GetOrigin (  )