AddAtom

【勇芳软件工作室】汉化HomePreviousNext

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