网站首页  词典首页

请输入您要查询的函数:

 

术语 globaldeleteatom
释义 GlobalDeleteAtom
语法:
ATOM GlobalDeleteAtom( ATOM nAtom
);
GlobalDeleteAtom功能
该GlobalDeleteAtom函数递减一个全球性的字符串原子的引用计数。如果原子的引用计数为零,GlobalDeleteAtom删除与原子从全局原子表相关的字符串。
参数
nAtom
[in]标识原子和字符串被删除。
返回值
该函数总是返回(原子)0。
要确定是否函数失败,调用SetLastError(ERROR_SUCCESS),然后再调用GlobalDeleteAtom,然后调用GetLastError函数。如果最后一个错误代码仍然ERROR_SUCCESS,GlobalDeleteAtom成功。
备注
字符串原子的引用计数指定次数的字符串已被添加到原子表。该GlobalAddAtom函数增量的一个字符串,它已在全球原子表中的每个调用时存在的引用计数。
每个GlobalAddAtom呼吁应该有相应的要求,以GlobalDeleteAtom。不要调用GlobalDeleteAtom比您多次调用GlobalAddAtom,或者您可能会删除原子,而其他客户使用。应用程序使用动态数据交换(DDE)应遵循全球原子管理规则,以防止泄漏和过早删除。
GlobalDeleteAtom并没有对一个整数原子效应(原子,它的值的范围是0x0001到0xBFFF)。该函数总是返回一个整数原子为零。
例如
有关示例,请参阅启动一个会话。
功能信息
最低DLL版本 kernel32.dll
在Winbase.h HeaderDeclared,头文件:winuser.h
import libraryKernel32.lib
最低操作系统Windows 95,Windows NT 3.1
UnicodeImplemented为Unicode版本。
参见
atoms OverView,AddAtom,DeleteAtom,FindAtom,GlobalAddAtom,GlobalFindAtom,MAKEINTATOM
==英文原文==GlobalDeleteAtom Function
The GlobalDeleteAtom function decrements the reference count of a global string atom. If the atom's reference count reaches zero, GlobalDeleteAtom removes the string associated with the atom from the global atom table.
Syntax
ATOM GlobalDeleteAtom( ATOM nAtom
);
Parameters
nAtom
[in] Identifies the atom and character string to be deleted.
Return Value
The function always returns (ATOM) 0.
To determine whether the function has failed, call SetLastError (ERROR_SUCCESS) before calling GlobalDeleteAtom, then call GetLastError . If the last error code is still ERROR_SUCCESS, GlobalDeleteAtom has succeeded.
Remarks
A string atom's reference count specifies the number of times the string has been added to the atom table. The GlobalAddAtom function increments the reference count of a string that already exists in the global atom table each time it is called.
Each call to GlobalAddAtom should have a corresponding call to GlobalDeleteAtom. Do not call GlobalDeleteAtom more times than you call GlobalAddAtom, or you may delete the atom while other clients are using it. Applications using Dynamic Data Exchange (DDE) should follow the rules on global atom management to prevent leaks and premature deletion.
GlobalDeleteAtom has no effect on an integer atom (an atom whose value is in the range 0x0001 to 0xBFFF). The function always returns zero for an integer atom.
Example
For an example, see Initiating a Conversation .
Function Information
Minimum DLL Versionkernel32.dll
HeaderDeclared in Winbase.h, include Windows.h
Import libraryKernel32.lib
Minimum operating systemsWindows 95, Windows NT 3.1
UnicodeImplemented as Unicode version.
See Also
Atom Overview , AddAtom , DeleteAtom , FindAtom , GlobalAddAtom , GlobalFindAtom , MAKEINTATOM
==原始网址==http://msdn.microsoft.com/en-us/library/ms649061(VS.85).aspx\n
随便看

 

windows api函数参考手册包含2258条windows api函数文档,详细介绍nodejs、java、rust调用windows api的方法技巧,是学习windows api编程的入门中文文档。

 

Copyright © 2004-2023 Winrtm.com All Rights Reserved
京ICP备2021023879号-40 更新时间:2024/10/6 13:15:41