InitAtomTable 函数 (winbase.h)

初始化本地原子表，并将哈希桶数设置为指定大小。

语法

BOOL InitAtomTable(
  [in] DWORD nSize
);

[in] nSize

类型：DWORD

要用于原子表的哈希桶数。如果此参数为零，则创建默认的哈希桶数。

若要获得更好的性能，请在 nSize 中指定质数。

类型： BOOL

如果该函数成功，则返回值为非零值。

如果函数失败，则返回值为零。

应用程序无需使用此函数来使用本地 atom 表。使用的默认哈希桶数为 37。但是，如果应用程序确实使用 InitAtomTable，则应先调用函数，然后再调用任何其他 atom-management 函数。

如果应用程序使用大量本地原子，则它可以减少将原子添加到局部原子表或通过增加表的大小在表中查找原子所需的时间。但是，这会增加维护表所需的内存量。

无法更改全局 atom 表中的存储桶数。如果原子表已经初始化，无论是通过之前对 InitAtomTable 的调用显式初始化，还是通过使用任何 atom-management 函数隐式初始化， InitAtomTable 将返回成功，而不会更改哈希桶的数量。

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	winbase.h (包括 Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll