Функция GetAtomNameA (winbase.h)

Статья
08/27/2023

Извлекает копию строки символов, связанной с указанным локальным атомом.

Синтаксис

UINT GetAtomNameA(
  [in]  ATOM  nAtom,
  [out] LPSTR lpBuffer,
  [in]  int   nSize
);

Параметры

[in] nAtom

Тип: ATOM

Локальный атом, определяющий извлекаемую строку символов.

[out] lpBuffer

Тип: LPTSTR

Строка символов.

[in] nSize

Тип: int

Размер буфера (в символах).

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

Тип: UINT

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

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

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

Вопросы безопасности

Неправильное использование этой функции может поставить под угрозу безопасность программы. Неправильное использование этой функции включает неправильное указание размера параметра lpBuffer .

Примечание

Заголовок winbase.h определяет GetAtomName в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winbase.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll