| 术语 | localunlock |
| 释义 | LocalUnlock 语法： C++ BOOL WINAPI LocalUnlock( __in HLOCAL hMem ); LocalUnlock功能 递减计数的锁的内存对象，与LMEM_MOVEABLE分配有关。这个函数没有与LMEM_FIXED分配的内存对象的影响。 注意当地的职能，并提供更大的开销比其他内存管理功能较少的功能。新的应用程序应该使用堆文档指出，除非当地的职能应常用的功能。有关更多信息，请参阅全局和局部的功能。 参数 hMem [in] 句柄到本地内存对象。这是处理不论是由LocalAlloc或LocalReAlloc函数返回。 返回值 如果内存对象仍然锁定后递减计数锁定，则返回值为非零。如果内存对象锁定锁定后递减计数，该函数返回0，GetLastError返回NO_ERROR。 如果函数失败，返回值为零，GetLastError返回值比NO_ERROR等。 备注 每个内存对象内部数据结构包括一个锁计数最初为零。对于可移动内存对象，LocalLock函数递增计数之一，LocalUnlock递减计数一。对于每次调用一个进程使以LocalLock为对象，它必须最终调用LocalUnlock。锁定的内存将无法移动或丢弃，除非内存对象是使用LocalReAlloc职能重新分配。在锁定内存对象的内存块保持锁定状态，直到其锁计数递减为零，到时可以移动或丢弃。 如果内存对象已经锁定，LocalUnlock返回FALSE，而且GetLastError报告ERROR_NOT_LOCKED。分配了内存中的对象LMEM_FIXED始终有一个零锁计数，并导致ERROR_NOT_LOCKED错误。 阿进程不应该依靠返回值来确定的次数必须随后呼吁内存块LocalUnlock。 要求： 最低支持：client－Windows 2000专业版 最低支持server－Windows 2000服务器 HeaderWinbase.h(头文件：winuser.h) LibraryKernel32.lib DLLKernel32.dll 参见 全局和局部功能 LocalAlloc LocalFlags LocalLock LocalReAlloc 内存管理功能 如果有任何问题和意见，请发送给微软(wsddocfb@microsoft.com) 生成日期：2009年8月27日 ＝＝英文原文＝＝LocalUnlock Function Decrements the lock count associated with a memory object that was allocated with LMEM_MOVEABLE. This function has no effect on memory objects allocated with LMEM_FIXED. Note The local functions have greater overhead and provide fewer features than other memory management functions. New applications should use the heap functions unless documentation states that a local function should be used. For more information, see Global and Local Functions . Syntax C++ BOOL WINAPI LocalUnlock( __in HLOCAL hMem ); Parameters hMem [in] A handle to the local memory object. This handle is returned by either the LocalAlloc or LocalReAlloc function. Return Value If the memory object is still locked after decrementing the lock count, the return value is nonzero. If the memory object is unlocked after decrementing the lock count, the function returns zero and GetLastError returns NO_ERROR. If the function fails, the return value is zero and GetLastError returns a value other than NO_ERROR. Remarks The internal data structures for each memory object include a lock count that is initially zero. For movable memory objects, the LocalLock function increments the count by one, and LocalUnlock decrements the count by one. For each call that a process makes to LocalLock for an object, it must eventually call LocalUnlock. Locked memory will not be moved or discarded unless the memory object is reallocated by using the LocalReAlloc function. The memory block of a locked memory object remains locked until its lock count is decremented to zero, at which time it can be moved or discarded. If the memory object is already unlocked, LocalUnlock returns FALSE and GetLastError reports ERROR_NOT_LOCKED. Memory objects allocated with LMEM_FIXED always have a lock count of zero and cause the ERROR_NOT_LOCKED error. A process should not rely on the return value to determine the number of times it must subsequently call LocalUnlock for the memory block. Requirements Minimum supported clientWindows 2000 Professional Minimum supported serverWindows 2000 Server HeaderWinbase.h (include Windows.h) LibraryKernel32.lib DLLKernel32.dll See Also Global and Local Functions LocalAlloc LocalFlags LocalLock LocalReAlloc Memory Management Functions Send comments about this topic to Microsoft Build date: 8/27/2009 ＝＝原始网址＝＝http://msdn.microsoft.com/en-us/library/aa366747(VS.85).aspx\n |
| 随便看 |
|
windows api函数参考手册包含2258条windows api函数文档，详细介绍nodejs、java、rust调用windows api的方法技巧，是学习windows api编程的入门中文文档。