LocalFlags

小甲鱼

注：本文档由 百日维新 翻译，小甲鱼校对。

原文链接 -> 传送门

函数功能：

LocalFlags 函数用于获取指定的局部内存对象的信息。

注释：该函数是为了兼容 16 位的 Windows 版本而提供。新的应用程序应该使用堆内存管理函数。更多信息参见备注。


API 函数原型：

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

UINT WINAPI LocalFlags(
  _In_ HLOCAL hMem
);

参数解析：

参数	含义
hMem	1. 指向局部内存对象的句柄 2. 该句柄由 LocalAlloc 函数或者 LocalReAlloc 函数获得

返回值：

1. 如果函数调用成功，返回值中存放内存对象的分配值和锁计数。

2. 如果函数调用失败，返回值是 LMEM_INVALID_HANDLE ，表明 hMem 参数不是一个有效值。

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


备注：

1. 返回值低位字节的低 8 位含有内存对象的锁计数。使用 LMEM_LOCKCOUNT 与返回值进行按位与操作，获取锁计数。以 LMEM_FIXED 参数值分配的内存对象锁计数总是为 0。

2. 返回值低位字节的高 8 位表示内存对象分配值，可为 0 或 LMEM_DISCARDABLE。

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


需求：

Minimum supported client	Windows xp [仅桌面应用程序]
Minimum supported server	Windows 2003 服务器版 [仅桌面应用程序]
Header	WinBase.h (包含于 Windows.h)
Library	Kernel32.lib
DLL	Kernel32.dll

【API档案】版权归鱼C工作室（www.fishc.com）所有，转载请注明来源。