StrFromTimeIntervalA, fonction (shlwapi.h)

Article
11/20/2024

Convertit un intervalle de temps, spécifié en millisecondes, en chaîne.

Syntaxe

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

Paramètres

[out] pszOut

Type : PTSTR

Pointeur vers une mémoire tampon qui, lorsque cette fonction retourne correctement, reçoit le nombre converti.

cchMax

Type : uiNT

Taille de pszOut, en caractères. Si cchMax est défini sur zéro, StrFromTimeInterval retourne la taille minimale de la mémoire tampon de caractères nécessaire pour contenir la chaîne convertie. Dans ce cas, pszOut ne contiendra pas la chaîne convertie.

dwTimeMS

Type : DWORD

Intervalle de temps, en millisecondes.

digits

Type : int

Nombre maximal de chiffres significatifs à représenter dans pszOut. Voici quelques exemples :

dwTimeMS	Chiffres	pszOut
34000	3	34 secondes
34000	2	34 secondes
34000	1	30 secondes
74000	3	1 min 14 s
74000	2	1 min 10 s
74000	1	1 min

Valeur de retour

Type : int

Renvoie le nombre de caractères dans pszOut, à l’exception de la fin caractère NULL.

Remarques

La valeur de temps retournée dans pszOut sera toujours sous la forme hh heures mm minutes ss secondes. Les heures supérieures à vingt quatre heures ne sont pas converties en jours ou mois. Les fractions de secondes sont ignorées.

Exemples

#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

Note

L’en-tête shlwapi.h définit StrFromTimeInterval comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	shlwapi.h
bibliothèque	Shlwapi.lib
DLL	Shlwapi.dll (version 4.71 ou ultérieure)

Partager via