Thread32First 함수(tlhelp32.h)

시스템 스냅샷 발생한 프로세스의 첫 번째 스레드에 대한 정보를 검색합니다.

구문

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

매개 변수

[in] hSnapshot

CreateToolhelp32Snapshot 함수에 대한 이전 호출에서 반환된 스냅샷 대한 핸들입니다.

[in, out] lpte

THREADENTRY32 구조체에 대한 포인터입니다.

반환 값

스레드 목록의 첫 번째 항목이 버퍼에 복사되었으면 TRUE 를 반환하고 그렇지 않으면 FALSE 를 반환합니다. 스레드가 없거나 스냅샷 스레드 정보가 없는 경우 GetLastError 함수에서 ERROR_NO_MORE_FILES 오류 값이 반환됩니다.

설명

호출 애플리케이션은 THREADENTRY32dwSize 멤버를 구조체의 크기(바이트)로 설정해야 합니다. Thread32First 는 구조체에 기록된 바이트 수로 dwSize 를 변경합니다. 이는 dwSize의 초기 값보다 크지 않지만 작을 수 있습니다. 값이 작은 경우 오프셋이 이 값보다 큰 멤버의 값을 사용하지 마세요.

동일한 스냅샷 기록된 다른 스레드에 대한 정보를 검색하려면 Thread32Next 함수를 사용합니다.

예제

예를 들어 스레드 목록 트래버스를 참조하세요.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 tlhelp32.h
라이브러리 Kernel32.lib
DLL Kernel32.dll

참고 항목

CreateToolhelp32Snapshot

THREADENTRY32

스레드 보행

Thread32Next

도구 도움말 함수