ResumeThread 함수(processthreadsapi.h)

  • 아티클

스레드의 일시 중단 횟수를 감소합니다. 일시 중단 횟수가 0으로 감소하면 스레드 실행이 다시 시작됩니다.

구문

DWORD ResumeThread(
  [in] HANDLE hThread
);

매개 변수

[in] hThread

다시 시작할 스레드에 대한 핸들입니다.

이 핸들에는 THREAD_SUSPEND_RESUME 액세스 권한이 있어야 합니다. 자세한 내용은 스레드 보안 및 액세스 권한을 참조하세요.

반환 값

함수가 성공하면 반환 값은 스레드의 이전 일시 중단 횟수입니다.

함수가 실패하면 반환 값은 (DWORD) -1입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

ResumeThread 함수는 주체 스레드의 일시 중단 횟수를 확인합니다. 일시 중단 횟수가 0이면 스레드가 현재 일시 중단되지 않습니다. 그렇지 않으면 주체 스레드의 일시 중단 수가 감소합니다. 결과 값이 0이면 주체 스레드의 실행이 다시 시작됩니다.

반환 값이 0이면 지정된 스레드가 일시 중단되지 않았습니다. 반환 값이 1이면 지정된 스레드가 일시 중단되었지만 다시 시작되었습니다. 반환 값이 1보다 크면 지정된 스레드가 여전히 일시 중단됩니다.

디버그 이벤트를 보고하는 동안 보고 프로세스 내의 모든 스레드는 고정됩니다. 디버거는 SuspendThread 및 ResumeThread 함수를 사용하여 프로세스 내에서 실행할 수 있는 스레드 집합을 제한해야 합니다. 디버그 이벤트를 보고하는 스레드를 제외한 프로세스의 모든 스레드를 일시 중단하면 단일 스레드를 "단일 단계"로 실행할 수 있습니다. 다른 스레드는 일시 중단된 경우 계속 작업에 의해 해제되지 않습니다.

Windows Phone 8.1: 이 함수는 Windows Phone 8.1 이상에서 Windows Phone 스토어 앱에서 지원됩니다.

Windows 8.1 및 Windows Server 2012 R2: 이 함수는 Windows 8.1, Windows Server 2012 R2 이상에서 Windows 스토어 앱에서 지원됩니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 processthreadsapi.h(Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2에 Windows.h 포함)
라이브러리 Kernel32.lib; Windows Phone 8.1의 WindowsPhoneCore.lib
DLL Kernel32.dll; Windows Phone 8.1의 KernelBase.dll

추가 정보

OpenThread

프로세스 및 스레드 함수

SuspendThread

스레드 실행 일시 중단

스레드