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
 
ATOM WinFindAtom(hAtomTbl, pszAtomName)
HATOMTBL hAtomTbl;    /* handle of the atom table */
PSZ pszAtomName;      /* address of the atom name */
 
The WinFindAtom function finds an atom in the atom table. This function is
identical to the WinAddAtom function, with two exceptions: If the atom name
is not found in the table, it is not added to the table and NULL is returned
as the value of this function; if the atom name is found in the table, the
use count is not increased.
 
Because integer atoms do not have a use count and do not actually occupy
memory in the atom table, this function is identical to WinAddAtom with
respect to integer atoms.
 
Parameter    Description
────────────────────────────────────────────────────────────────────────────
 
hAtomTbl     Identifies the atom table. This handle must have been created
             by a previous call to the WinCreateAtomTable function.
 
pszAtomName  Points to the null-terminated character string containing the
             atom name. If the string begins with a "#" character, the ASCII
             digits that follow are converted into an integer atom. If the
             string begins with an "!" character, the next two bytes are
             interpreted as an atom. If the high word of this parameter is
             -1, the low word is an atom and that atom is returned.
 
Return Value
 
The return value is the atom associated with the passed string, or it is
NULL if the string is not in the atom table.
 
See Also
 
WinAddAtom, WinCreateAtomTable
 
                                      ♦