LocalDiscard 宏（minwinbase.h）

放弃指定的本地内存对象。内存对象的锁计数必须为零。

注意本地函数的开销更大，并且提供的功能比其他内存管理功能少。除非文档指出应使用本地函数，否则新应用程序应使用堆函数。有关详细信息，请参阅全局函数和本地函数。

语法

HLOCAL LocalDiscard(
  [in]  HLOCAL h
);

[in] h

本地内存对象的句柄。 LocalAlloc 或 LocalReAlloc 函数返回此句柄。

类型： HLOCAL

如果函数成功，则返回值是本地内存对象的句柄。如果函数失败，则返回值为 NULL。若要获取扩展的错误信息，请调用 GetLastError。

虽然 LocalDiscard 放弃对象的内存块，但对象的句柄仍然有效。随后，进程可以将句柄传递给 LocalReAlloc 函数，以分配由同一句柄标识的另一个本地内存对象。