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

Статья
08/27/2023

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

Синтаксис

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