GlobalGetAtomName

Syntax

WORD GlobalGetAtomName(nAtom,lpBuffer,nSize)

This function retrieves a copy of the character string associated with the nAtom parameter and places it in the buffer pointed to by the lpBuffer parameter. The nSize parameter specifies the maximum size of the buffer. (A global atom is an atom that is available to all Windows applications.)

Parameter Type/Description  

nAtom ATOM Identifies the character string to be retrieved.  
lpBuffer LPSTR Points to the buffer that is to receive the character string.  
nSize int Specifies the maximum size (in bytes) of the buffer.  

Return Value

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