다음을 통해 공유


KillTimer 함수(winuser.h)

지정된 타이머를 삭제합니다.

구문

BOOL KillTimer(
  [in, optional] HWND     hWnd,
  [in]           UINT_PTR uIDEvent
);

매개 변수

[in, optional] hWnd

형식: HWND

지정된 타이머와 연결된 창에 대한 핸들입니다. 이 값은 타이머를 만든 SetTimer 함수에 전달된 hWnd 값과 동일해야 합니다.

[in] uIDEvent

형식: UINT_PTR

파괴할 타이머입니다. SetTimer에 전달된 창 핸들이 유효한 경우 이 매개 변수는 nIDEvent와 동일해야 합니다.

SetTimer에 전달된 값입니다. 애플리케이션에서 hWndNULL로 설정된 SetTimer을 호출하는 경우 이 매개 변수는 SetTimer에서 반환된 타이머 식별자여야 합니다.

반환 값

형식: BOOL

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

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

설명

KillTimer 함수는 메시지 큐에 이미 게시된 WM_TIMER 메시지를 제거하지 않습니다.

예제

예를 들어 타이머 삭제를 참조하세요.

요구 사항

   
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 winuser.h(Windows.h 포함)
라이브러리 User32.lib
DLL User32.dll
API 세트 ext-ms-win-ntuser-window-l1-1-2(Windows 10 버전 10.0.10240에 도입됨)

추가 정보

개념

참조

SetTimer

타이머

WM_TIMER