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

Статья
11/20/2024

Добавляет символьную строку в глобальную таблицу atom и возвращает уникальное значение (атом), определяющее строку.

Синтаксис

ATOM GlobalAddAtomExA(
  [in, optional] LPCSTR lpString,
  [in]           DWORD  Flags
);

Параметры

[in, optional] lpString

Добавляемая строка, завершающаяся значением NULL. Строка может иметь максимальный размер 255 байт. Строки, которые отличаются только в случае, считаются идентичными. Случай первой строки этого имени, добавленной в таблицу, сохраняется и возвращается функцией GlobalGetAtomName.

Кроме того, можно использовать целый атом, который был преобразован с помощью макроса MAKEINTATOM. Дополнительные сведения см. в примечаниях.

[in] Flags

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

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

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

Замечания

Заметка

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

Требования

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

См. также

GlobalAddAtom

Поделиться через