网站首页  词典首页

请输入您要查询的函数:

 

术语 deleteatom
释义 DeleteAtom
语法:
ATOM DeleteAtom( ATOM nAtom
);
DeleteAtom功能
该DeleteAtom函数递减的本地字符串原子的引用计数。如果原子的引用计数减少到零,DeleteAtom删除与当地原子表原子相关的字符串。
参数
nAtom
[in]标识原子被删除。
返回值
如果函数成功,返回值是零。
如果函数失败,返回值是nAtom参数。为了获得更多错误信息,调用GetLastError。
备注
字符串原子的引用计数指定的次数增加了原子的原子表。该AddAtom递增函数在每个呼叫计数。函数递减的DeleteAtom在每个呼叫计数,但删除字符串只有在原子的引用计数为零。
每个AddAtom呼吁应该有相应的要求,以DeleteAtom。不要调用DeleteAtom比您多次呼吁AddAtom,或者您可能会删除原子,而其他客户使用。
该DeleteAtom函数没有对一个整数原子效应(原子,它的值的范围是0x0001到0xBFFF)。该函数总是返回一个整数原子为零。
功能信息
最低DLL版本 kernel32.dll
在Winbase.h HeaderDeclared,头文件:winuser.h
import libraryKernel32.lib
最低操作系统Windows 95,Windows NT 3.1
UnicodeImplemented为Unicode版本。
参见
原子,AddAtom,FindAtom,GlobalAddAtom,GlobalDeleteAtom,GlobalFindAtom,MAKEINTATOM
==英文原文==DeleteAtom Function
The DeleteAtom function decrements the reference count of a local string atom. If the atom's reference count is reduced to zero, DeleteAtom removes the string associated with the atom from the local atom table.
Syntax
ATOM DeleteAtom( ATOM nAtom
);
Parameters
nAtom
[in] Identifies the atom to be deleted.
Return Value
If the function succeeds, the return value is zero.
If the function fails, the return value is the nAtom parameter. To get extended error information, call GetLastError .
Remarks
A string atom's reference count specifies the number of times the atom has been added to the atom table. The AddAtom function increments the count on each call. The DeleteAtom function decrements the count on each call but removes the string only if the atom's reference count is zero.
Each call to AddAtom should have a corresponding call to DeleteAtom. Do not call DeleteAtom more times than you call AddAtom, or you may delete the atom while other clients are using it.
The DeleteAtom function 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.
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
Atoms , AddAtom , FindAtom , GlobalAddAtom , GlobalDeleteAtom , GlobalFindAtom , MAKEINTATOM
==原始网址==http://msdn.microsoft.com/en-us/library/ms649057(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 更新时间:2025/1/9 4:17:11