Функция GetAtomNameA (winbase.h)
Извлекает копию строки символов, связанной с указанным локальным атомом.
Синтаксис
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 |
См. также
Справочные материалы