ChangeTimerQueueTimer 함수(threadpoollegacyapiset.h)

CreateTimerQueueTimer 함수에서 만든 타이머 큐 타이머를 업데이트.

구문

BOOL ChangeTimerQueueTimer(
  [in, optional] HANDLE TimerQueue,
  [in, out]      HANDLE Timer,
  [in]           ULONG  DueTime,
  [in]           ULONG  Period
);

매개 변수

[in, optional] TimerQueue

타이머 큐에 대한 핸들입니다. 이 핸들은 CreateTimerQueue 함수에서 반환됩니다.

이 매개 변수가 NULL인 경우 타이머는 기본 타이머 큐와 연결됩니다.

[in, out] Timer

타이머 큐 타이머에 대한 핸들입니다. 이 핸들은 CreateTimerQueueTimer 함수에 의해 반환됩니다.

[in] DueTime

타이머가 만료되어야 하는 시간(밀리초)입니다.

[in] Period

타이머 기간(밀리초)입니다. 이 매개 변수가 0이면 타이머에 한 번 신호가 전송됩니다. 이 매개 변수가 0보다 크면 타이머가 주기적입니다. 주기적 타이머는 DeleteTimerQueueTimer 함수를 사용하여 타이머가 취소되거나 ChangeTimerQueueTimer를 사용하여 다시 설정될 때까지 마침표가 경과할 때마다 자동으로 다시 활성화됩니다.

반환 값

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

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

설명

스레드가 가장을 사용하는 동안에는 이 함수를 호출할 수 없습니다. 결과 동작이 정의되지 않았습니다.

타이머 콜백에서 ChangeTimerQueueTimer 를 호출할 수 있습니다.

이미 만료된 원샷 타이머(해당 기간이 0임)에서 ChangeTimerQueueTimer 를 호출하면 타이머가 업데이트되지 않습니다.

핸들 에서 DeleteTimerQueueTimer 를 호출한 후 ChangeTimerQueueTimer 를 호출하지 마세요.

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

요구 사항

참고 항목

CreateTimerQueue

CreateTimerQueueTimer

DeleteTimerQueueTimer

동기화 함수

스레드 풀링

타이머 큐