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

Статья
08/27/2023

Инициализирует локальную таблицу atom и задает указанное количество хэш-контейнеров.

Синтаксис

BOOL InitAtomTable(
  [in] DWORD nSize
);

Параметры

[in] nSize

Тип: DWORD

Количество хэш-контейнеров, используемых для таблицы atom. Если этот параметр равен нулю, создается количество хэш-контейнеров по умолчанию.

Чтобы повысить производительность, укажите простое число в nSize.

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

Тип: BOOL

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

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

Приложение не обязательно использовать эту функцию для использования локальной таблицы atom. По умолчанию используется число хэш-контейнеров 37. Однако если приложение использует InitAtomTable, оно должно вызывать функцию перед любой другой функцией управления атомами.

Если приложение использует большое количество локальных атомов, оно может сократить время, необходимое для добавления атома в локальную таблицу atom или поиска атома в таблице путем увеличения размера таблицы. Однако это увеличивает объем памяти, необходимый для обслуживания таблицы.

Количество контейнеров в глобальной таблице atom изменить нельзя. Если таблица atom уже инициализирована (явным образом путем предварительного вызова InitAtomTable или неявно с помощью любой функции управления атомами), InitAtomTable возвращает успешное выполнение без изменения количества хэш-контейнеров.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winbase.h (включая Windows.h)
Библиотека	Kernel32.lib
DLL	Kernel32.dll