Fonction StrFromTimeIntervalA (shlwapi.h)
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) |