GlobalGetAtomName
The GlobalGetAtomName
function retrieves a copy of the character string associated with the specified
global atom.
UINT GlobalGetAtomName(
|
ATOM nAtom, |
// atom identifier |
|
LPTSTR lpBuffer, |
// pointer to the
buffer for the atom string |
|
int nSize |
// size of the
buffer |
|
); |
|
Parameters
nAtom
Identifies
the global atom associated with the character string to be retrieved.
lpBuffer
Points to the
buffer for the character string.
nSize
Specifies the
size, in characters, of the buffer.
Return Values
If the
function succeeds, the return value is the length of the string copied to the
buffer, in characters, not including the terminating null character.
If the
function fails, the return value is zero. To get extended error information,
call GetLastError.
Remarks
The string
returned for an integer atom (an atom created by the MAKEINTATOM macro)
is a null-terminated string in which the first character is a pound sign (#)
and the remaining characters represent the unsigned integer originally passed
to MAKEINTATOM.
See Also