globalLock 函式 (winbase.h)

鎖定全域記憶體物件，並傳回物件記憶體區塊之第一個位元組的指標。

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

 

語法

LPVOID GlobalLock(
  [in] HGLOBAL hMem
);

參數

[in] hMem

全域記憶體物件的控制碼。 GlobalAlloc或GlobalReAlloc函式會傳回此控制碼。

傳回值

如果函式成功，傳回值會是記憶體區塊第一個位元組的指標。

如果函式失敗，傳回值為 Null。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

每個記憶體物件的內部資料結構都包含一開始為零的鎖定計數。 對於可移動的記憶體物件， GlobalLock 會將計數遞增一， 而 GlobalUnlock 函式會將計數遞減一。 對物件進行 進程對 GlobalLock 進行的每個成功呼叫都必須與 GlobalUnlock的對應呼叫進行比對。 除非使用 GlobalReAlloc 函式重新配置記憶體物件，否則不會移動或捨棄鎖定的記憶體。 鎖定記憶體物件的記憶體區塊會維持鎖定狀態，直到鎖定計數遞減為零為止，此時可以移動或捨棄它。

配置 GMEM_FIXED 的記憶體物件一律具有零的鎖定計數。 針對這些物件，傳回指標的值等於指定控制碼的值。

如果已捨棄指定的記憶體區塊，或記憶體區塊的大小為零位元組，則此函式會傳回 Null。

捨棄的物件一律會有零的鎖定計數。

規格需求

最低支援的用戶端	Windows XP [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器	Windows Server 2003 [傳統型應用程式 |UWP 應用程式]
目標平台	Windows
標頭	winbase.h (包含 Windows.h)
程式庫	Kernel32.lib
DLL	Kernel32.dll

另請參閱

全域和區域函式

GlobalAlloc

GlobalReAlloc

GlobalUnlock

記憶體管理功能