LocalLock

原文链接 -> 传送门

函数功能：

LocalLock 函数用于锁定局部内存对象并返回一个指向该对象内存块第一字节的指针。

注释：与其他内存管理函数相比，局部内存管理函数有更大的开销却提供更少的功能。除非指出使用局部内存管理函数，不然新的应用程序应该使用堆内存管理函数。更多信息请查阅 Global and Local Functions。


API 函数原型：

注释：_In_ 说明该参数是输入的。

LPVOID WINAPI LocalLock(
  _In_ HLOCAL hMem
);

参数解析：
 

返回值：

1. 如果函数调用成功，返回一个指向该对象内存块第一字节的指针；

2. 如果函数调用失败，返回值为 NULL。

若想获得更多的错误信息，请调用 GetLastError 函数。


备注：

1. 每个内存对象的内部数据结构包含一个将会初始化为 0 的锁计数。对于可移动内存对象，LocalLock 函数会将锁计数值加 1，LocalUnlock 函数将锁计数值减 1。对于 LocalLock 的每一次调用，都必须相应的调用一次 LocalUnlock 函数。除非使用 LocalReAlloc 函数对内存对象进行重新分配，否则被锁定的内存空间不能够被移动或废弃。直到锁计数值减少为 0 时被锁定的内存块才会解锁并可以被移动或者释放。

2. 以 LMEM_FIXED 属性分配的内存块空间的锁计数值始终为 0。对于这样的对象，函数的返回指针即为该句柄。

3. 如果指定的内存块已经被废弃或者大小为 0 字节，该函数返回 NULL。

4. 废弃后的对象的锁计数值为 0。


需求：