GlobalAddAtom

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

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