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


Функция Thread32First (tlhelp32.h)

Извлекает сведения о первом потоке любого процесса, обнаруженного в системном snapshot.

Синтаксис

BOOL Thread32First(
  [in]      HANDLE          hSnapshot,
  [in, out] LPTHREADENTRY32 lpte
);

Параметры

[in] hSnapshot

Дескриптор snapshot возвращен при предыдущем вызове функции CreateToolhelp32Snapshot.

[in, out] lpte

Указатель на структуру THREADENTRY32 .

Возвращаемое значение

Возвращает значение TRUE , если первая запись списка потоков была скопирована в буфер или false в противном случае. Значение ошибки ERROR_NO_MORE_FILES возвращается функцией GetLastError, если потоки не существуют или snapshot не содержит сведений о потоках.

Комментарии

Вызывающее приложение должно задать члену dwSizeTHREADENTRY32 размер структуры в байтах. Thread32First изменяет dwSize на количество байтов, записанных в структуру. Это значение никогда не будет больше начального значения dwSize, но может быть меньше. Если значение меньше, не следует полагаться на значения элементов, смещения которых больше этого значения.

Чтобы получить сведения о других потоках, записанных в той же snapshot, используйте функцию Thread32Next.

Примеры

Пример см. в разделе Обход списка потоков.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header tlhelp32.h
Библиотека Kernel32.lib
DLL Kernel32.dll

См. также

CreateToolhelp32Snapshot

THREADENTRY32

Ход потока

Thread32Далее

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