localFlags 函数 (winbase.h)

检索有关指定本地内存对象的信息。

注意提供此函数只是为了与 16 位版本的 Windows 兼容。新应用程序应使用堆函数。有关详细信息，请参阅“备注”。

语法

UINT LocalFlags(
  [in] HLOCAL hMem
);

[in] hMem

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

如果函数成功，则返回值指定内存对象的分配值和锁计数。

如果函数失败，则返回值 LMEM_INVALID_HANDLE，指示本地句柄无效。要获得更多的错误信息，请调用 GetLastError。

返回值的低序字的低序字节包含对象的锁计数。若要从返回值检索锁计数，请将 LMEM_LOCKCOUNT 掩码与按位 AND (&) 运算符一起使用。使用 LMEM_FIXED 分配的内存对象的锁计数始终为零。

返回值的低序字的高位字节指示内存对象的分配值。可以是零或 LMEM_DISCARDABLE。

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