GetAtomName
Функция GetAtomName возвращает копию символьной строки, связанной с указанным локальным атомом. Эта функция заменяет функцию GetAtomHandle .
UINT
GetAtomName (
ATOM
nAtom
, // атом, идентифицирующий символьную строку
LPTSTR
lpBuffer
, // адрес буфера для строки атома
int
nSize
// размер буфера
);
Параметры
nAtom
- определяет локальный атом, который идентифицирует получаемую символьную строку.
lpBuffer
- указывает на буфер для символьной строки.
nSize - определяет размер буфера в символах.
Возвращаемые значения
В случае успеха возвращается длина скопированной
в буфер строки, в символах, не считая завершающий нулевой символ.
В случае неудачи возвращается нуль. Для получения дополнительной
информации об ошибке вызовите функцию GetLastError
.
Примечания
Строка, возвращаемая для целочисленного атома (созданного макросом MAKEINTATOM ) - завершающаяся нулем строка, в которой первым символом является символ '#', а оставшиеся символы представляют беззнаковое целое, первоначально переданное MAKEINTATOM .
См. также
AddAtom , DeleteAtom , FindAtom , GlobalAddAtom , GlobalDeleteAtom , GlobalFindAtom , GlobalGetAtomName , MAKEINTATOM .