Функция Process32First (tlhelp32.h)
Извлекает сведения о первом процессе, обнаруженном в системном snapshot.
Синтаксис
BOOL Process32First(
[in] HANDLE hSnapshot,
[in, out] LPPROCESSENTRY32 lppe
);
Параметры
[in] hSnapshot
Дескриптор snapshot возвращен из предыдущего вызова функции CreateToolhelp32Snapshot.
[in, out] lppe
Указатель на структуру PROCESSENTRY32 . Он содержит сведения о процессе, такие как имя исполняемого файла, идентификатор процесса и идентификатор родительского процесса.
Возвращаемое значение
Возвращает значение TRUE , если первая запись списка процессов была скопирована в буфер, или false в противном случае. Значение ошибки ERROR_NO_MORE_FILES возвращается функцией GetLastError, если процессы не существуют или snapshot не содержит сведений о процессе.
Комментарии
Вызывающее приложение должно задать члену dwSizePROCESSENTRY32 размер структуры в байтах.
Чтобы получить сведения о других процессах, записанных в том же snapshot, используйте функцию Process32Next.
Примеры
Пример см. в разделе Создание моментального снимка и просмотр процессов.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Целевая платформа | Windows |
| Header | tlhelp32.h |
| Библиотека | Kernel32.lib |
| DLL | Kernel32.dll |