Fonction StrFromTimeIntervalA (shlwapi.h)

Article
08/26/2023

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 contient 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. 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 minute

Valeur retournée

Type : int

Retourne le nombre de caractères dans pszOut, à l’exclusion du caractère NULL de fin.

Remarques

La valeur de temps retournée dans pszOut sera toujours au format hh hours mm minutes ss secondes. Les heures qui dépassent 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

Notes

L’en-tête shlwapi.h définit StrFromTimeInterval comme un 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.

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlwapi.h
Bibliothèque	Shlwapi.lib
DLL	Shlwapi.dll (version 4.71 ou ultérieure)

Partager via