globalFlags 函式 (winbase.h)

擷取指定之全域記憶體對象的相關信息。

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

語法

UINT GlobalFlags(
  [in] HGLOBAL hMem
);

[in] hMem

全域記憶體物件的句柄。 GlobalAlloc 或 GlobalReAlloc 函式會傳回此句柄。

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

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

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

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

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