GlobalAddAtom函数将一个字符串添加到全局原子表,并返回一个唯一的值(一个原子),用于标识字符串。
ATOM GlobalAddAtom(
LPCTSTR 【lpString】 | //指向要添加的字符串的指针 |
); |
参数
【lpString】
指向要添加的以null结尾的字符串。该字符串的最大长度可以为255字节。仅在情况下不同的字符串被认为是相同的。添加到表中的该名称的第一个字符串的情况由GlobalGetAtomName功能保留并返回。
返回值
如果函数成功,则返回值是新创建的原子。
如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.
备注
如果字符串已经存在于全局原子表中,则返回现有字符串的原子,并将原子的引用计数递增。
与原子关联的字符串不会从内存中删除,直到引用计数为零。有关详细信息,请参阅GlobalDeleteAtom功能。
当应用程序终止时,全局原子不会自动删除。对于GlobalAddAtom功能的每次呼叫,必须对GlobalDeleteAtom功能进行相应调用。
GlobalAddAtom返回一个字符串atom,其值在0xC000到0xFFFF之间。
如果【lpString】参数的形式为“#1234”,则GlobalAddAtom返回一个整数原子,其值为字符串中指定的十进制数字的16位表示形式(在此示例中为0x04D2)。如果指定的十进制值为0x0000或0xC000到0xFFFF范围内的值,则返回值为零,表示错误。如果【lpString】在0x0001到0xBFFF的范围内,则返回值为【lpString】的低位字。
MAKEINTATOM宏可用于将WORD值转换为可以使用GlobalAddAtom函数添加到原子表的字符串。
也可以看看
AddAtom, DeleteAtom, FindAtom, GetAtomName, GlobalDeleteAtom, GlobalFindAtom, GlobalGetAtomName, MAKEINTATOM