DeleteTimerQueueEx 함수(threadpoollegacyapiset.h)

타이머 큐를 삭제합니다. 큐의 보류 중인 타이머는 취소되고 삭제됩니다.

구문

BOOL DeleteTimerQueueEx(
  [in]           HANDLE TimerQueue,
  [in, optional] HANDLE CompletionEvent
);

[in] TimerQueue

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

[in, optional] CompletionEvent

함수가 성공하고 모든 콜백 함수가 완료되었을 때 신호를 받을 이벤트 개체에 대한 핸들입니다. 이 매개 변수는 NULL일 수 있습니다.

이 매개 변수가 INVALID_HANDLE_VALUE 경우 함수는 반환하기 전에 모든 콜백 함수가 완료되기를 기다립니다.

이 매개 변수가 NULL이면 함수는 삭제할 타이머를 표시하고 즉시 반환합니다. 그러나 대부분의 호출자는 필요한 정리를 수행할 수 있도록 콜백 함수가 완료될 때까지 기다려야 합니다.

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

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

타이머 콜백 내에서 DeleteTimerQueueEx 에 대한 차단 호출을 수행하지 마세요.

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