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