| UINT GetAtomName(atm, lpszBuffer, cchBuffer) | |||||
| ATOM atm; | /* atom identifying character string | */ | |||
| LPTSTR lpszBuffer; | /* address of the buffer for the atom string | */ | |||
| DWORD cchBuffer; | /* size of buffer | */ | |||
The GetAtomName function retrieves a copy of the character string associated with the specified local atom.
atm
Specifies the local atom that identifies the character string to be retrieved.
lpszBuffer
Points to the buffer for the character string.
cchBuffer
Specifies the maximum size of the buffer (in characters).
The return value specifies the length of the string copied to the buffer, (in characters) not including the terminating null character. The return value is zero if the specified atom is not valid.
The GetAtomName 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).