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

Статья
11/20/2024

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

Синтаксис

UINT GetAtomNameW(
  [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 определяет GetAtomName как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

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