Platform SDK: Interprocess Communications |
The GlobalGetAtomName function retrieves a copy of the character string associated with the specified global atom.
UINT GlobalGetAtomName( ATOM nAtom, // atom identifier LPTSTR lpBuffer, // buffer for atom string int nSize // size of buffer );
If the function succeeds, the return value is the length of the string copied to the buffer, in TCHARs, not including the terminating null character.
If the function fails, the return value is zero. To get extended error information, call GetLastError.
The string returned for an integer atom (an atom whose value is in the range 0x0001 to 0xBFFF) is a null-terminated string in which the first character is a pound sign (#) and the remaining characters represent the unsigned integer atom value.
Windows NT/2000: Requires Windows NT 3.1 or later.
Windows 95/98: Requires Windows 95 or later.
Header: Declared in Winbase.h; include Windows.h.
Library: Use Kernel32.lib.
Unicode: Implemented as Unicode and ANSI versions on Windows NT/2000.
Atoms Overview, Atom Functions, AddAtom, DeleteAtom, FindAtom, GlobalAddAtom, GlobalDeleteAtom, GlobalFindAtom, MAKEINTATOM