win12.hlp (Table of Contents; Topic list)
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.
WinDeleteAtom (1.2)
Function Group  Overview                          Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_WINATOM
 
ATOM WinDeleteAtom(hAtomTbl, atom)
HATOMTBL hAtomTbl;    /* handle of the atom table */
ATOM atom;            /* atom                     */
 
The WinDeleteAtom function deletes an atom from the atom table.
 
Parameter  Description
────────────────────────────────────────────────────────────────────────────
 
hAtomTbl   Identifies the atom table. This handle must have been created by
           a previous call to the WinCreateAtomTable function.
 
atom       Specifies the atom to be deleted.
 
Return Value
 
The return value is NULL if the function is successful. Otherwise, it is
equal to the value of the atom parameter if the function failed and the atom
has not been deleted.
 
If the passed atom is an integer atom, NULL is returned. If it is not an
integer atom and it is a valid atom for the given atom table (it has an atom
name and use count associated with it), the use count is decreased by one
and NULL is returned. If the use count has been decreased to zero, the atom
name and use count are removed from the atom table.
 
See Also
 
WinAddAtom, WinCreateAtomTable