See Also
 Important: |
|---|
| This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist. |
An atomis 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 Windows Embedded CE–based functions accept either strings or atoms as parameters. When an application passes an atom to these functions, an application can use the MAKEINTATOMmacro 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 macro | Description |
|---|---|
|
Adds a character string to the global atom table and returns a unique value, known as an atom, that identifies string. |
|
|
Decrements the reference count of a global string atom. When GlobalDeleteAtomdecrements the reference count for the atom to zero, GlobalDeleteAtomremoves the string associated with the atom from the global atom table. |
|
|
Searches the global atom table for the specified character string and retrieves the global atom associated with that string. |
|
|
Converts the specified atom into a string so that an application can pass the atom to functions that accept either atoms or strings. |