GlobalAddAtom
计算机系统函数
GlobalAddAtom是一个计算机系统函数。
函数功能
只适用于桌面应用程序
向全局原子表添加一个字符串,并返回这个字符串的唯一标识符(原子ATOM)。
函数原型
ATOM WINAPI GlobalAddAtom〔
_In_ LPCTSTR lpString
〕;
参数
lpString [in]
类型: LPCTSTR
GlobalGetAtomName函数得到添加的字符串。
或者,你也可以使用MAKEINTATOM宏创建一个整数原子。更多有关信息,请参阅“备注”。
返回值
类型: ATOM
函数调用成功,则返回值为新创建的原子(ATOM)。
若函数调用失败,则返回值为0。调用GetLastError获得更多的错误信息
情况说明
如果字符串中已经存在于全局原子表中,则返回现有的字符串的原子,并且原子的引用计数加1。
与原子相关的字符串不会从内存中删除,直到它的引用计数为零。欲了解更多信息,请参阅GlobalDeleteAtom函数。
全局原子不会在应用程序终止时自动删除。每次调用GlobalAddAtom函数,必须相应的调用GlobalDeleteAtom函数删除原子。
如果lpString是其他形式的字符串,则GlobalAddAtom返回这个字符串原子。
MAKEINTATOM宏的定义如下:
#define MAKEINTATOM(i) (LPTSTR)((ULONG_PTR)((WORD)(i)))
系统需求
Minimum supported client: Windows 2000 Professional
Minimum supported server: Windows 2000 Server
Header: Winbase.h (include Windows.h)
Library: Kernel32.lib
DLL: Kernel32.dll
Unicode and ANSI names: GlobalAddAtomW (Unicode) and GlobalAddAtomA (ANSI)
参考资料
GlobalAddAtom function.MSDN.2012-7-20
最新修订时间:2023-12-18 23:14
目录
概述
函数功能
函数原型
参数
参考资料