CreateTimerQueue 함수(threadpoollegacyapiset.h)

타이머에 대한 큐를 만듭니다. 타이머 큐 타이머는 지정된 시간에 호출할 콜백 함수를 지정할 수 있는 경량 개체입니다.

구문

HANDLE CreateTimerQueue();

함수가 성공하면 반환 값은 타이머 큐에 대한 핸들입니다. 이 핸들은 타이머 큐에 대한 핸들이 필요한 함수에서만 사용할 수 있습니다.

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

큐에 타이머를 추가하려면 CreateTimerQueueTimer 함수를 호출합니다. 큐에서 타이머를 제거하려면 DeleteTimerQueueTimer 함수를 호출합니다.

타이머 큐가 완료되면 DeleteTimerQueueEx 함수를 호출하여 타이머 큐를 삭제합니다. 큐의 보류 중인 타이머는 모두 취소되고 삭제됩니다.

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

CreateTimerQueue를 사용하는 예제는 타이머 큐 사용을 참조하세요.