3.8 Atom-Management Functions

Atom-management functions create and manipulate atoms. Atoms are integers that uniquely identify character strings. They are useful in applications that use many character strings and in applications that need to conserve memory. Windows stores atoms in atom tables. A local atom table is allocated in an application's data segment; it cannot be accessed by other applications. The global atom table can be shared and is useful in applications that use dynamic data exchange (DDE). Following are the atom-management functions:

Function Description

AddAtom Creates an atom for a character string.
DeleteAtom Deletes an atom if the reference count is zero.
FindAtom Retrieves an atom associated with a character string.
GetAtomHandle Retrieves a handle (relative to the local heap) of the string that corresponds to a specified atom.
GetAtomName Copies the character string associated with an atom.
GlobalAddAtom Creates a global atom for a character string.
GlobalDeleteAtom Deletes a global atom if the reference count is zero.
GlobalFindAtom Retrieves a global atom associated with a character string.
GlobalGetAtomName Copies the character string associated with a global atom.
InitAtomTable Initializes an atom hash table.

The MAKEINTATOM macro can also be used to cast an integer for use as a function argument.