GlobalAddAtomExA 函数 (winbase.h)

  • 项目

将字符串添加到全局原子表，并返回一个唯一值 (atom) 标识该字符串。

语法

ATOM GlobalAddAtomExA(
  [in, optional] LPCSTR lpString,
  [in]           DWORD  Flags
);

参数

[in, optional] lpString

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

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

[in] Flags

返回值

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

如果函数失败，则返回值为零。 要获得更多的错误信息，请调用 GetLastError。

注解

注意

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

要求

   
目标平台 Windows
标头 winbase.h (包括 Windows.h)
Library Kernel32.lib
DLL Kernel32.dll

另请参阅

GlobalAddAtom