Windows Win32Sincronizaçãokernel32.dll
SetWaitableTimer
Arma um temporizador sincronizável para disparar em um horário absoluto ou após um intervalo, opcionalmente repetindo.
Descrição
Contraparte de configuração de CreateWaitableTimerW.
Header:
synchapi.hDLL: kernel32.dllNative API: NtSetTimerAssinatura
BOOL SetWaitableTimer(
HANDLE hTimer,
const LARGE_INTEGER * lpDueTime,
LONG lPeriod,
PTIMERAPCROUTINE pfnCompletionRoutine,
LPVOID lpArgToCompletionRoutine,
BOOL fResume
);Parâmetros
| Parâmetro | Tipo | Descrição |
|---|---|---|
| hTimer | HANDLE | Handle do temporizador. |
| lpDueTime | const LARGE_INTEGER * | Horário de disparo (negativo = relativo, positivo = absoluto, em unidades de 100ns). |
| lPeriod | LONG | Intervalo de repetição em milissegundos, ou 0 para disparo único. |
| pfnCompletionRoutine | PTIMERAPCROUTINE | Rotina de conclusão opcional, invocada quando a thread está alertable. |
| lpArgToCompletionRoutine | LPVOID | Argumento passado à rotina de conclusão. |
| fResume | BOOL | Se TRUE, tira o sistema de suspensão quando o temporizador dispara. |
Valor de retorno
Diferente de zero em sucesso; 0 em erro (consulte GetLastError).
Códigos de erro (GetLastError)
- ERROR_INVALID_HANDLE(6)
- O identificador (handle) informado é inválido.