ATOM AddAtom(lpString)
This function adds the character string pointed to by the lpString parameter to the atom table and creates a new atom that uniquely identifies the string. The atom can be used in a subsequent GetAtomName function to retrieve the string from the atom table.
The AddAtom function stores no more than one copy of a given string in the atom table. If the string is already in the table, the function returns the existing atom value and increases the string's reference count by one.
| Parameter | Type/Description |
| lpString | LPSTR Points to the character string to be added to the table. The string must be a null-terminated character string. |
The return value specifies the newly created atom if the function is successful. Otherwise, it is NULL.
The atom values returned by AddAtom range from 0xC000 to 0xFFFF. Atoms are case insensitive.