Função timeGetTime (timeapi.h)
A função timeGetTime recupera o tempo do sistema, em milissegundos. A hora do sistema é o tempo decorrido desde que o Windows foi iniciado.
Sintaxe
DWORD timeGetTime();
Retornar valor
Retorna a hora do sistema, em milissegundos.
Comentários
A única diferença entre essa função e a função timeGetSystemTime é que timeGetSystemTime usa a estrutura MMTIME para retornar a hora do sistema. A função timeGetTime tem menos sobrecarga do que timeGetSystemTime.
Observe que o valor retornado pela função timeGetTime é um valor DWORD . O valor retornado é encapsulado em torno de 0 a cada 2^32 milissegundos, que é de cerca de 49,71 dias. Isso pode causar problemas no código que usa diretamente o valor de retorno timeGetTime em computações, especialmente quando o valor é usado para controlar a execução do código. Você sempre deve usar a diferença entre dois valores de retorno timeGetTime em cálculos.
A precisão padrão da função timeGetTime pode ser de cinco milissegundos ou mais, dependendo do computador. Você pode usar as funções timeBeginPeriod e timeEndPeriod para aumentar a precisão de timeGetTime. Se você fizer isso, a diferença mínima entre valores sucessivos retornados por timeGetTime poderá ser tão grande quanto o valor de período mínimo definido usando timeBeginPeriod e timeEndPeriod. Use as funções QueryPerformanceCounter e QueryPerformanceFrequency para medir intervalos de tempo curtos em alta resolução.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | timeapi.h (inclua Windows.h) |
| Biblioteca | Winmm.lib |
| DLL | Winmm.dll |