共用方式為


localLock 函式 (winbase.h)

鎖定本機記憶體物件,並傳回物件記憶體區塊第一個字節的指標。

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

語法

LPVOID LocalLock(
  [in] HLOCAL hMem
);

參數

[in] hMem

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

傳回值

如果函式成功,傳回值會是記憶體區塊第一個字節的指標。

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

備註

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

配置 LMEM_FIXED 的記憶體物件一律具有零的鎖定計數。 針對這些對象,傳回指標的值等於指定句柄的值。

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

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

規格需求

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

另請參閱

全域和區域函式

LocalAlloc

LocalFlags

LocalReAlloc

LocalUnlock

記憶體管理功能