Closes a Designer library
| Call | ||
| #include <vv_des.h> | ||
| int dl_close(libp) | ||
|
DLIBPTR libp |
Pointer to Designer library to close |
|
| Returns | ||
| 1 | The library was successfully closed | |
| 0 | Error. The global error code VV_ERR is set to one of the following: | |
| ERRCLOSE | The Designer library could not be closed | |
| FL_NUNLOCKED | The Designer library could not be unlocked | |
| Description
dl_close() closes the specified Designer library. If the library was locked, dl_close() unlocks it. If there are no forms or windows using this library's logical attribute array, this logical attribute array is removed from the linked list of library logical attribute arrays and freed. The memory for the library structure and the string holding the library name is freed. |
||
| Related Functions | ||
| Cautions
You must close all open Designer libraries before leaving your application. You can do this by calling dl_close() for each library. You can also ensure that all libraries are closed by calling vv_exit() just before returning in main() and in any of your abort functions. dl_close() frees the DLIBPTR allocated by dl_open(). Do not use this pointer after closing the Designer library. |
||