术语 | 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编程的入门中文文档。