Process32First 函式 (tlhelp32.h)

擷取系統快照集中所遇到的第一個進程相關信息。

語法

BOOL Process32First(
  [in]      HANDLE           hSnapshot,
  [in, out] LPPROCESSENTRY32 lppe
);

[in] hSnapshot

從先前呼叫 CreateToolhelp32Snapshot 函式傳回之快照集的句柄。

[in, out] lppe

PROCESSENTRY32 結構的指標。它包含進程資訊，例如可執行檔的名稱、進程標識碼，以及父進程的進程標識碼。

如果進程清單的第一個專案已複製到緩衝區，則傳回 TRUE ，否則傳回 FALSE 。如果沒有任何進程存在或快照集不包含進程資訊，GetLastError 函式會傳回ERROR_NO_MORE_FILES錯誤值。

呼叫的應用程式必須將 PROCESSENTRY32 的 dwSize 成員設定為結構的大小，以位元組為單位。

若要擷取相同快照中記錄之其他進程的相關信息，請使用 Process32Next 函式。