GlobalAddAtomExW 函数（winbase.h）

将字符串添加到全局 atom 表，并返回标识字符串的唯一值（原子）。

语法

ATOM GlobalAddAtomExW(
  [in, optional] LPCWSTR lpString,
  [in]           DWORD   Flags
);

[in, optional] lpString

要添加的以 null 结尾的字符串。字符串的最大大小可以为 255 字节。仅区分大小写的字符串被视为相同。此名称添加到表的第一个字符串的事例由 GlobalGetAtomName 函数保留并返回。

或者，可以使用已使用 MAKEINTATOM 宏转换的整数原子。有关详细信息，请参阅“备注”。

[in] Flags

如果函数成功，则返回值为新创建的 atom。

如果函数失败，则返回值为零。若要获取扩展的错误信息，请调用 GetLastError。

注意

winbase.h 标头将 GlobalAddAtomEx 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。