dl_close()

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

dl_fmget(), dl_mnget(), dl_open()

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.


Home Contents Previous Next