Using Atoms (Windows CE 5.0)

Windows CE 5.0
Send Feedback

An atom is a 16-bit integer that identifies a string that an application stores together with the atom in an operating system (OS) defined table known as an atom table. The application can later use the atom to access the string. A string that an application places in an atom table is called an atom name.

Several Microsoft® Windows® CE–based functions accept either strings or atoms as parameters. When an application passes an atom to these functions, an application can use the MAKEINTATOM macro to convert the atom into a form that the function can use.

The following table lists the functions and macros that enable an application to use atoms.

Function or macroDescription
GlobalAddAtomAdds a character string to the global atom table and returns a unique value, known as an atom, that identifies string.
GlobalDeleteAtomDecrements the reference count of a global string atom. When GlobalDeleteAtom decrements the reference count for the atom to zero, GlobalDeleteAtom removes the string associated with the atom from the global atom table.
GlobalFindAtomSearches the global atom table for the specified character string and retrieves the global atom associated with that string.
MAKEINTATOMConverts the specified atom into a string so that an application can pass the atom to functions that accept either atoms or strings.

See Also

Shell Application Development | Atoms Reference

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.