Поделиться через


Функция 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

См. также

CreateToolhelp32Snapshot

PROCESSENTRY32

Ход выполнения процесса

Процесс32Далее

Функции справки по инструментам