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

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

cchMax

Tipo: UINT

Tamaño de pszOut, en caracteres. Si cchMax se establece 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á la cadena convertida.

dwTimeMS

Tipo: DWORD

Intervalo de tiempo, en milisegundos.

digits

Tipo: int

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

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 min

Valor devuelto

Tipo: int

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

Comentarios

El valor de tiempo devuelto en pszOut siempre estará en el formato hh horas mm minutos ss segundos. Las horas 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 Convenciones para prototipos de función.

Requisitos

Cliente mínimo compatible	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shlwapi.h
Library	Shlwapi.lib
Archivo DLL	Shlwapi.dll (versión 4.71 o posterior)