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 .

Hosted by uCoz