GlobalAddAtom( cString )-> <nAtom>
------------------------------------------------------------------------------


 PARAMETER:

  <cString> is the string to be added to the system atom table. The case of
            the string added is preserved and returned by GlobalGetAtomName.
            Strings that differ only in case are considered identical. 


 RETURNS:

  <nAtom> is a numeric value that identifies the string. You can think of
  it as of a Clipper symbol.



 DESCRIPTION:

  GlobalAddAtom() adds a string to the system atom table and returns a
  unique value identifying that string. 
  If the string already exists in the table, the atom for the existing 
  string will be returned and the atom's reference count will be incremented
  by one. The string associated with the atom will not be deleted from 
  memory until its reference count is zero.


 EXAMPLE:


    +--------------------------------------------------------------+
    |  /* Add a Atom */                                            |
    |  MsgInfo( GlobalAddAtom( "FiveWin" ))                        |
    +--------------------------------------------------------------+

 SOURCE:

  SOURCE\WINAPI\ATOM.C