Callback Locations

DB Interface Module User's Guide
Rogue Wave web site: Home Page | Main Documentation Page

10.2 Callback Locations

Callbacks are provided at both the database level and the connection level. The following three callbacks are provided at the database level:

preEnvAllocate() — This callback is invoked just before the allocation of a database-specific environment/context handle.
postEnvAllocate() — This callback is invoked after the allocation of the database-specific environment/context handle. The callback is invoked after all the SourcePro DB default properties have been set on the allocated environment/context handle.
preEnvDestroy() — This callback is invoked just before the deallocation of the database-specific environment/context handle but after all the SourcePro DB configuration is complete. As this callback is typically called from the destructor of the RWDBDatabase object, you should refrain from throwing an exception.

The following six callbacks are provided at the connection level:

preConnAllocate() — This callback is invoked just before the allocation of the database-specific connection handle but after all the SourcePro DB configuration is complete.
postConnAllocate() — This callback is invoked just after the allocation of the database-specific connection handle but before the SourcePro DB properties have been set.
preConnect() — This callback is invoked just before establishing the database connection but after all the SourcePro DB configuration is complete.
postConnect() — This callback is invoked after all the SourcePro DB default properties have been set and the database connection is established.
preDisconnect() — This callback is invoked just before the database connection is closed but after all the SourcePro DB configuration is complete. As this callback is typically called from the destructor of the RWDBConnection object, you should refrain from throwing an exception.
preConnDestroy() — This callback is invoked just before the deallocation of the connection handle but after all the SourcePro DB configuration is complete. As this callback is typically called from the destructor of the RWDBConnection object, you should refrain from throwing an exception.

For the precise location of the callbacks and any applicable restrictions, please refer to the User's Guide of the particular Access Module you are using.

Figure 4: Callback flow chart

The Rogue Wave name and logo, and SourcePro, are registered trademarks of Rogue Wave Software. All other trademarks are the property of their respective owners.
Provide feedback to Rogue Wave about its documentation.