GlobalGetAtomName

  UINT GlobalGetAtomName(atm, lpszBuffer, cchBuffer)    
  ATOM atm; /* atom */
  LPTSTR lpszBuffer; /* address of buffer for atom string */
  DWORD cchBuffer; /* size of buffer */

The GlobalGetAtomName function retrieves a copy of the character string associated with the specified global atom.

Parameters

atm

Identifies the global atom associated with the character string to be retrieved.

lpszBuffer

Points to the buffer for the character string.

cchBuffer

Specifies the size, in characters, of the buffer.

Return Value

The return value specifies the actual number of characters copied to the buffer. It is zero if the specified global atom is not valid.

Comments

The GlobalGetAtomName function may be used as either a wide-character function (where text arguments must use Unicode) or an ANSI function (where text arguments must use characters from the Windows 3.x character set installed).

See Also

GlobalFindAtom, GlobalDeleteAtom, GlobalAddAtom