The features described in this topic are obsolete
and should not be used in new IDL code.
HANDLE_FREE
This routine is obsolete and should not be used in new IDL code.
The HANDLE_FREE procedure frees an existing handle, along with any dynamic memory currently being used by its value. Any child handles associated with ID are also freed.
Syntax
HANDLE_FREE, ID
Arguments
ID
The ID of the handle to be freed. Once the handle is freed, further use of it is invalid and causes an error to be issued.
Example
To free all memory associated with the top-level handle top, and all its children, use the command: