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

另请参阅

AddAtom

DeleteAtom

FindAtom

GlobalAddAtom

GlobalFindAtom

MAKEINTATOM

引用