GlobalGetAtomName

Функция GlobalGetAtomName извлекает копию строки символов, связанной с указанным глобальным атомом.

UINT GlobalGetAtomName (

    ATOM nAtom , // идентификатор атома
    LPTSTR lpBuffer , // указатель на буфер для строки
    int nSize  // размер буфера
  );

Параметры

nAtom - идентифицирует глобальный атом, связанный с извлекаемой строкой символов.
lpBuffer - указывает на буфер для строки символов.
nSize - указывает размер буфера в символах.

Возвращаемые значения

В случае успеха возвращается длина строки, в символах, скопированной в буфер, не считая завершающий нулевой символ.
В случае неудачи возвращается нуль. Для получения дополнительной информации об ошибке вызовите функцию GetLastError .

Комментарии

Строка, возвращаемая для целого атома (атома, созданного макросом MAKEINTATOM ), представляет собой завершающуюся нулем строку, в которой первым символом является символ фунта ('#'), а оставшиеся символы - беззнаковое целое, первоначально переданное в макрос MAKEINTATOM .

См. также

AddAtom , DeleteAtom , FindAtom , GlobalAddAtom , GlobalDeleteAtom , GlobalFindAtom , MAKEINTATOM .