共用方式為


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錯誤值。

備註

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

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

範例

如需範例,請參閱 擷取快照集和檢視程式

規格需求

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

另請參閱

CreateToolhelp32Snapshot

PROCESSENTRY32

程式逐步執行

Process32Next

工具說明函式