company logo

ObjectSpace :: forceClose - Force closing an access handle

When closing access handles for an object space, database or dictionary, the reference count for the handle object will be reduced. The access handle object, however, is closed only when the reference count became 0. Calling this function will immediately close the access handle object regardless on the number of access handles referring to it.

Destroying an access handle object also destroys all subordinated access handle objects, i.e. when forcing closing a dictionary, all subordinated access objects for databases, object spaces and property handles will be closed and referring handles become invalid.

When the handle is not valid, the function throws an exception.

Notes:

Storing dictionary handles in context classes will increase the use count for the dictionary or database access handle object. Thus, closing the handle in the application will not really destroy the dictionary or database handle object.

Implementation details

ObjectSpace  :: forceClose (  )