localFlags 函式 (winbase.h)

擷取指定之本機記憶體物件的相關信息。

注意此函式僅適用於與16位版本的Windows相容。新的應用程式應該使用堆積函式。如需詳細資訊，請參閱＜備註＞。

語法

UINT LocalFlags(
  [in] HLOCAL hMem
);

[in] hMem

本機記憶體物件的句柄。 LocalAlloc 或 LocalReAlloc 函式會傳回此句柄。

如果函式成功，傳回值會指定記憶體物件的配置值和鎖定計數。

如果函式失敗，傳回值 會LMEM_INVALID_HANDLE，表示本機句柄無效。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

傳回值低序字組的低序位元組包含對象的鎖定計數。若要從傳回值擷取鎖定計數，請使用具有位 AND (&) 運算子的 LMEM_LOCKCOUNT 遮罩。使用 LMEM_FIXED 配置之內存物件的鎖定計數一律為零。

傳回值低序字組的高序位元組表示記憶體物件的配置值。它可以是零或 LMEM_DISCARDABLE。

本機函式具有更大的額外負荷，並提供比其他記憶體管理功能少的功能。除非檔指出應該使用本機函式，否則新的應用程式應該使用堆積函式。如需詳細資訊，請參閱全域和區域函式。