Module32First 函式 (tlhelp32.h)

擷取與進程相關聯之第一個模組的相關信息。

語法

BOOL Module32First(
  [in]      HANDLE          hSnapshot,
  [in, out] LPMODULEENTRY32 lpme
);

[in] hSnapshot

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

[in, out] lpme

MODULEENTRY32 結構的指標。

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

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

若要擷取與指定進程相關聯之其他模組的相關信息，請使用 Module32Next 函式。

如需範例，請參閱周遊模組清單。