AddAtom函数将一个字符串添加到本地atom表中,并返回一个标识字符串的唯一值(atom)。
ATOM AddAtom(
LPCTSTR 【lpString】 | //指向要添加的字符串的指针 |
); |
参数
【lpString】
指向要添加的以null结尾的字符串。该字符串的最大长度可以为255字节。仅在情况下不同的字符串被认为是相同的。添加的第一个字符串的情况由GetAtomName函数保留并返回。
返回值
如果函数成功,则返回值是新创建的原子。
如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.
备注
AddAtom函数在原子表中存储不超过一个给定字符串的副本。如果字符串已经在表中,那么该函数返回现有的原子,在字符串原子的情况下,递增该字符串的引用计数。
MAKEINTATOM宏可用于将WORD值转换为可以使用AddAtom函数添加到原子表的字符串。
AddAtom返回一个字符串atom,其值在0xC000到0xFFFF之间。
如果【lpString】具有“#1234”的形式,AddAtom返回一个整数原子,其值是字符串中指定的十进制数字的16位表示形式(在此示例中为0x04D2)。如果指定的十进制值为0x0000或0xC000到0xFFFF范围内的值,则返回值为零,表示错误。如果【lpString】在0x0001到0xBFFF的范围内,则返回值为【lpString】的低位字。
也可以看看
DeleteAtom, FindAtom, GetAtomName, GlobalAddAtom, GlobalDeleteAtom, GlobalFindAtom, GlobalGetAtomName, MAKEINTATOM