Функция GlobalGetAtomNameA (winbase.h)
Извлекает копию символьной строки, связанной с указанным глобальным атомом.
Синтаксис
UINT GlobalGetAtomNameA(
[in] ATOM nAtom,
[out] LPSTR lpBuffer,
[in] int nSize
);
Параметры
[in] nAtom
Тип: ATOM
Глобальный атом, связанный с извлекаемой символьной строкой.
[out] lpBuffer
Тип: LPTSTR
Буфер для символьной строки.
[in] nSize
Тип: int
Размер буфера (в символах).
Возвращаемое значение
Тип: UINT
Если функция выполняется успешно, возвращаемое значение — это длина строки, скопированной в буфер, в символах, не включая завершающий пустой символ.
Если функция выполняется неудачно, возвращается нулевое значение. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.
Комментарии
Строка, возвращаемая для целочисленного атома (атома, значение которого находится в диапазоне 0x0001 0xBFFF), является строкой, заканчивающейся null, в которой первый символ является знаком фунта (#), а остальные символы представляют целочисленное значение atom без знака.
Вопросы безопасности
Неправильное использование этой функции может поставить под угрозу безопасность программы. Неправильное использование этой функции включает неправильное указание размера параметра lpBuffer . Кроме того, обратите внимание, что глобальный атом доступен всем пользователям. таким образом, конфиденциальность и целостность его содержимого не гарантируется.Примечание
Заголовок winbase.h определяет GlobalGetAtomName в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | winbase.h (включая Windows.h) |
Библиотека | Kernel32.lib |
DLL | Kernel32.dll |
См. также
Справочные материалы