localHandle 函式 (winbase.h)

擷取與本機記憶體物件指定指標相關聯的句柄。

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

語法

HLOCAL LocalHandle(
  [in] LPCVOID pMem
);

[in] pMem

本機記憶體物件第一個字節的指標。 LocalLock 函式會傳回此指標。

如果函式成功，則傳回值是指定本機記憶體物件的句柄。

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

當 LocalAlloc 函式配置具有 LMEM_MOVEABLE的本機記憶體物件時，它會傳回物件的句柄。 LocalLock 函式會將這個句柄轉換成物件的記憶體區塊指標，LocalHandle 會將指標轉換成句柄。