globalHandle 函式 (winbase.h)

擷取與全域記憶體區塊之指定指標相關聯的句柄。

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

語法

HGLOBAL GlobalHandle(
  [in] LPCVOID pMem
);

參數

[in] pMem

全域記憶體區塊第一個字節的指標。 GlobalLock 函式會傳回此指標。

傳回值

如果函式成功,傳回值就是指定之全域記憶體物件的句柄。

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

備註

GlobalAlloc 函式配置具有 GMEM_MOVEABLE的記憶體物件時,它會傳回物件的句柄。 GlobalLock 函式會將這個句柄轉換成記憶體區塊的指標,而 GlobalHandle 會將指標轉換回句柄。

規格需求

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

另請參閱

全域和區域函式

GlobalAlloc

GlobalLock

記憶體管理功能