AddAtomW 函数 （winbase.h）
将字符串添加到本地 atom 表，并返回用于标识字符串的唯一值（原子）。
语法
ATOM AddAtomW(
[in] LPCWSTR lpString
);
参数
[in] lpString
类型：LPCTSTR
要添加的以 null 结尾的字符串。 字符串的最大大小可以为 255 字节。 仅当被视为相同的情况下，字符串才有所不同。 添加的第一个字符串的事例由 GetAtomName 函数保留并返回。
或者，可以使用已使用 MAKEINTATOM 宏转换的整数原子。 有关详细信息，请参阅“备注”。
返回值
类型：ATOM
如果函数成功，则返回值为新创建的 atom。
如果函数失败，则返回值为零。 若要获取扩展的错误信息，请调用 GetLastError。
言论
AddAtom 函数在 atom 表中存储给定字符串的多个副本。 如果字符串已在表中，则函数将返回现有原子，并在字符串原子的情况下递增字符串的引用计数。
如果 lpString 的格式为“#1234”，AddAtom 将返回一个整数原子，其值为字符串中指定的十进制数的 16 位表示形式（在本例中0x04D2）。 如果指定的十进制值0x0000或大于或等于0xC000，则返回值为零，指示错误。 如果 MAKEINTATOM 宏创建了 lpString，则低序单词必须位于0x0001到0xBFFF的范围内。 如果低序单词不在此范围内，函数将失败。
如果 lpString 具有任何其他形式，AddAtom 返回字符串原子。
注意
winbase.h 标头将 AddAtom 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 支持的最低服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | 窗户 |
| 标头 | winbase.h （包括 Windows.h） |
| 库 | Kernel32.lib |
| DLL | Kernel32.dll |
另请参阅
参考