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에 전달된 값입니다. 애플리케이션에서 hWnd가 NULL로 설정된 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에 도입됨)

개념

참조