|
|
Purpose
|
Indicates to the library that an 'atexit()' routine is _not_ to be installed. |
|
|
Return value
|
Returns SUCCEED (or 0) if successful and FAIL (or -1) otherwise. |
|
|
Description
|
This routine indicates to the library that an atexit( ) cleanup routine should not be installed. The purpose for this is in situations where the library is dynamically linked into an application and is unlinked from the application before exit( ) gets called. In those situations, a routine installed with atexit( ) would jump to a routine which was no longer in memory, causing errors. |
|
|
|
In order to be effective, this routine must be called before any other HDF function calls, and must be called each time the library is loaded/linked into the application (the first time and after it has been unloaded). |
|
|
|
If this routine is used, certain memory buffers will not be deallocated, although in theory a user could call HPend on their own. |