deleteAtom 函数 (winbase.h)

递减本地字符串原子的引用计数。如果原子的引用计数减少到零， DeleteAtom 将从本地 Atom 表中删除与原子关联的字符串。

语法

ATOM DeleteAtom(
  [in] ATOM nAtom
);

[in] nAtom

类型： ATOM

要删除的原子。

类型： ATOM

如果函数成功，则返回值为 0。

如果函数失败，则返回值为 nAtom 参数。要获得更多的错误信息，请调用 GetLastError。

字符串 atom 的引用计数指定原子已添加到 atom 表的次数。 AddAtom 函数在每次调用时递增计数。 DeleteAtom 函数会递减每次调用的计数，但仅当原子的引用计数为零时，才会删除字符串。

每次调用 AddAtom 都应具有对 DeleteAtom 的相应调用。调用 DeleteAtom 的次数不要多于调用 AddAtom 的次数，或者可以在其他客户端使用 Atom 时删除它。

DeleteAtom 函数对整数原子 (值在要0xBFFF) 0x0001范围内的原子没有影响。对于整数原子，函数始终返回零。

要求	值
最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	winbase.h (包括 Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll

引用