CancelWaitableTimer 함수(synchapi.h)

아티클
03/05/2024

지정된 대기 가능 타이머를 비활성 상태로 설정합니다.

구문

BOOL CancelWaitableTimer(
  [in] HANDLE hTimer
);

매개 변수

[in] hTimer

타이머 개체에 대한 핸들입니다. CreateWaitableTimer 또는 OpenWaitableTimer 함수는 이 핸들을 반환합니다. 핸들에 TIMER_MODIFY_STATE 액세스 권한이 있어야 합니다. 자세한 내용은 동기화 개체 보안 및 액세스 권한을 참조하세요.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

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

설명

CancelWaitableTimer 함수는 타이머의 신호 상태를 변경하지 않습니다. 타이머를 신호 상태로 설정하기 전에 중지하고 미해결 APC를 취소합니다. 따라서 타이머에서 대기 작업을 수행하는 스레드는 시간이 초과되거나 타이머가 다시 활성화되고 상태가 신호로 설정될 때까지 대기 상태로 유지됩니다. 타이머가 이미 신호 상태가면 해당 상태로 유지됩니다.

타이머를 다시 활성화하려면 SetWaitableTimer 함수를 호출합니다.

이 함수를 사용하는 애플리케이션을 컴파일하려면 _WIN32_WINNT 0x0400 이상으로 정의합니다. 자세한 내용은 Windows 헤더 사용을 참조하세요.

요구 사항

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