Función StrFromTimeIntervalA (shlwapi.h)

Convierte un intervalo de tiempo, especificado en milisegundos, en una cadena.

Sintaxis

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

Parámetros

[out] pszOut

Tipo: PTSTR de

Puntero a un búfer que, cuando esta función vuelve correctamente, recibe el número convertido.

cchMax

Tipo: UINT

Tamaño de pszOut, en caracteres. Si cchMax está establecido en cero, StrFromTimeInterval devolverá el tamaño mínimo del búfer de caracteres necesario para contener la cadena convertida. En este caso, pszOut no contendrán la cadena convertida.

dwTimeMS

Tipo: DWORD de

Intervalo de tiempo, en milisegundos.

digits

Tipo: int

Número máximo de dígitos significativos que se van a representar en pszOut. Algunos ejemplos son:

dwTimeMS	Dígitos	pszOut
34000	3	34 s
34000	2	34 s
34000	1	30 segundos
74000	3	1 min 14 s
74000	2	1 min 10 s
74000	1	1 minuto

Valor devuelto

Tipo: int

Devuelve el número de caracteres de pszOut, excepto el carácter de terminación NULL.

Observaciones

El valor de tiempo devuelto en pszOut siempre estará en el formulario hh horas mm minutos segundos. Los tiempos que superan las veinticuatro horas no se convierten en días o meses. Se omiten las fracciones de segundos.

Ejemplos

#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

Nota

El encabezado shlwapi.h define StrFromTimeInterval como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	shlwapi.h
biblioteca de	Shlwapi.lib
DLL de	Shlwapi.dll (versión 4.71 o posterior)