heap32ListFirst 函式 (tlhelp32.h)

發行項
03/02/2024

擷取指定進程所配置之第一個堆積的相關信息。

語法

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