Heap32First 函式 (tlhelp32.h)

擷取進程所配置堆積之第一個區塊的相關資訊。

語法

BOOL Heap32First(
  [in, out] LPHEAPENTRY32 lphe,
  [in]      DWORD         th32ProcessID,
  [in]      ULONG_PTR     th32HeapID
);

[in, out] lphe

HEAPENTRY32結構的指標。

[in] th32ProcessID

擁有堆積的進程內容識別碼。

[in] th32HeapID

要列舉之堆積的識別碼。

如果第一個堆積區塊的資訊已複製到緩衝區，則傳回 TRUE ，否則傳回 FALSE 。如果堆積無效或空白，GetLastError函式會傳回ERROR_NO_MORE_FILES錯誤值。

呼叫的應用程式必須將HEAPENTRY32的dwSize成員設定為結構的大小，以位元組為單位。 Heap32First 會將 dwSize 變更為寫入結構的位元組數目。這永遠不會大於 dwSize的初始值，但可能較小。如果值較小，請勿依賴任何位移大於此值的成員值。

若要存取相同堆積的後續區塊，請使用 Heap32Next 函式。

使用 堆積32First 和 Heap32Next 逐步執行堆積沒有效率，特別是針對大型堆積。請改用 HeapWalk 。

如需範例，請參閱周遊堆積清單。