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

Статья
11/20/2024

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

Синтаксис

UINT GlobalGetAtomNameW(
  [in]  ATOM   nAtom,
  [out] LPWSTR lpBuffer,
  [in]  int    nSize
);

Параметры

[in] nAtom

Тип: ATOM

Глобальный атом, связанный со строкой символа, которая должна быть извлечена.

[out] lpBuffer

Тип: LPTSTR

Буфер для строки символа.

[in] nSize

Тип: int

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

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

Тип: UINT

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

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

Замечания

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

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

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winbase.h (включая Windows.h)
библиотеки	Kernel32.lib
DLL	Kernel32.dll