Função StrFromTimeIntervalA (shlwapi.h)

Converte um intervalo de tempo, especificado em milissegundos, em uma cadeia de caracteres.

Sintaxe

int StrFromTimeIntervalA(
  [out] PSTR  pszOut,
        UINT  cchMax,
        DWORD dwTimeMS,
        int   digits
);

Parâmetros

[out] pszOut

Tipo: PTSTR

Um ponteiro para um buffer que, quando essa função retorna com êxito, recebe o número convertido.

cchMax

Tipo: UINT

O tamanho do pszOut, em caracteres. Se cchMax estiver definido como zero, StrFromTimeInterval retornará o tamanho mínimo do buffer de caracteres necessário para manter a cadeia de caracteres convertida. Nesse caso, pszOut não conterá a cadeia de caracteres convertida.

dwTimeMS

Tipo: DWORD

O intervalo de tempo, em milissegundos.

digits

Tipo: int

O número máximo de dígitos significativos a serem representados no pszOut. Alguns exemplos incluem:

Valor retornado

Tipo: int

Retorna o número de caracteres em pszOut, excluindo o caractere NULL de terminação.

Comentários

O valor de tempo retornado em pszOut sempre estará no formato hh horas mm minutos ss segundos . Os tempos que excedem vinte e quatro horas não são convertidos em dias ou meses. Frações de segundos são ignoradas.

Exemplos

#include <windows.h>
#include <iostream.h>
#include "Shlwapi.h"

void main(void)
{
    char TimeString[256];
    char *pszOut;
    pszOut = TimeString;

    cout << "The return value from the call to"
         << "\nthe function StrFromTimeInterval will"
         << "\nreturn the number of elements in the buffer: " << endl;

    cout << "\nThe return from StrFromTimeInterval is " 
         << StrFromTimeInterval(pszOut,30, 34000,30);

    cout << "\nThe contents of the TimeString Buffer " << pszOut << endl;

    cout << "The return from StrFromTimeInterval is " 
         << StrFromTimeInterval(pszOut,30, 74000,3);

    cout << "\nThe contents of the TimeString Buffer " << pszOut << endl;

    cout << "The return from StrFromTimeInterval is " 
         << StrFromTimeInterval(pszOut,30, 74000,2);

    cout << "\nThe contents of the TimeString Buffer " << pszOut << endl;

    cout << "The return from StrFromTimeInterval is " 
         << StrFromTimeInterval(pszOut,30, 74000,1)
         << "\nThe contents of the TimeString Buffer " << pszOut << endl;
}

OUTPUT:
- - - - -
The return value from the call to
the function StrFromTimeInterval will
return the number of elements in the buffer:

The return from StrFromTimeInterval is 7
The contents of the TimeString Buffer  34 sec
The return from StrFromTimeInterval is 13
The contents of the TimeString Buffer  1 min 14 sec
The return from StrFromTimeInterval is 13
The contents of the TimeString Buffer  1 min 10 sec
The return from StrFromTimeInterval is 6
The contents of the TimeString Buffer  1 min

Requisitos