GlobalDeleteAtom 函数 (winbase.h)
递减全局字符串原子的引用计数。 如果 atom 的引用计数达到零， GlobalDeleteAtom 将从全局原子表中删除与原子关联的字符串。
语法
ATOM GlobalDeleteAtom(
[in] ATOM nAtom
);
参数
[in] nAtom
类型： ATOM
要删除的 atom 和字符串。
返回值
类型： ATOM
函数始终返回 ATOM () 0 。
若要确定函数是否已失败，请在调用 GlobalDeleteAtom 之前使用 ERROR_SUCCESS 调用 SetLastError，然后调用 GetLastError。 如果最后一个错误代码仍 ERROR_SUCCESS，则 表示 GlobalDeleteAtom 已成功。
注解
字符串原子的引用计数指定字符串已添加到 atom 表的次数。 每次调用全局原子表时， GlobalAddAtom 函数都会递增已存在于全局原子表中的字符串的引用计数。
对 GlobalAddAtom 的每次调用都应具有对 GlobalDeleteAtom 的相应调用。 调用 GlobalDeleteAtom 的次数不要超过调用 GlobalAddAtom 的次数，或者可以在其他客户端使用它时删除 atom。 使用动态数据交换 (DDE) 的应用程序应遵循有关全局原子管理的规则，以防止泄漏和过早删除。
GlobalDeleteAtom 对整数原子 (值在0xBFFF) 0x0001范围内的原子没有影响。 函数始终返回整数原子的零。
示例
有关示例，请参阅 启动对话。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
| 最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
| 目标平台 | Windows |
| 标头 | winbase.h (包括 Windows.h) |
| Library | Kernel32.lib |
| DLL | Kernel32.dll |
另请参阅
引用