Important Notice

The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.

◄Function Group►  ◄Overview►                          ◄Up► ◄Next► ◄Previous►
────────────────────────────────────────────────────────────────────────────
 
#define INCL_WINATOM
 
HATOMTBL WinDestroyAtomTable(hAtomTbl)
HATOMTBL hAtomTbl;    /* handle of the atom table */
 
The WinDestroyAtomTable function destroys an atom table created by the
WinCreateAtomTable function.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hAtomTbl   Identifies the atom table to be destroyed. This handle must have
           been created by a previous call to the WinCreateAtomTable
           function.
 
Return Value
 
The return value is NULL if the function is successful. Otherwise, the
return value is the hAtomTbl parameter.
 
This method of returning failure allows for updating the status of an atom
table and destroying it at the same time with a call similar to the
following:
 
hAtomTbl = WinDestroyAtomTable(hAtomTbl);
 
See Also
 
WinCreateAtomTable, WinDestroyAccelTable, WinDestroyCursor, WinDestroyHeap,
WinDestroyMsgQueue, WinDestroyPointer, WinDestroyWindow
 
                                      ♦