heap32ListFirst 函式 (tlhelp32.h)
擷取指定進程所配置之第一個堆積的相關信息。
語法
BOOL Heap32ListFirst(
[in] HANDLE hSnapshot,
[in, out] LPHEAPLIST32 lphl
);
參數
[in] hSnapshot
從先前呼叫 CreateToolhelp32Snapshot 函式傳回之快照集的句柄。
[in, out] lphl
HEAPLIST32 結構的指標。
傳回值
如果堆積清單的第一個專案已複製到緩衝區，則傳回 TRUE ，否則傳回 FALSE 。 當沒有任何堆積清單存在或快照集不包含堆積清單資訊時，GetLastError 函式會傳回ERROR_NO_MORE_FILES錯誤值。
備註
呼叫的應用程式必須將 HEAPLIST32 的 dwSize 成員設定為 結構的大小，以位元組為單位。 Heap32ListFirst 會將 dwSize 變更為寫入結構的位元組數目。 這永遠不會大於 dwSize 的初始值，但可能較小。 如果值較小，請勿依賴任何位移大於此值的成員值。
若要擷取堆積清單中其他堆積的相關信息，請使用 Heap32ListNext 函式。
範例
如需範例，請參閱 周遊堆積清單。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | tlhelp32.h |
| 程式庫 | Kernel32.lib |
| DLL | Kernel32.dll |