StrFromTimeIntervalA-Funktion (shlwapi.h)

Konvertiert ein in Millisekunden angegebenes Zeitintervall in eine Zeichenfolge.

Syntax

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

Parameter

[out] pszOut

Typ: PTSTR

Ein Zeiger auf einen Puffer, der die konvertierte Zahl empfängt, wenn diese Funktion erfolgreich zurückgibt.

cchMax

Typ: UINT

Die Größe von pszOut in Zeichen. Wenn cchMax auf 0 festgelegt ist, gibt StrFromTimeInterval die Mindestgröße des Zeichenpuffers zurück, der zum Speichern der konvertierten Zeichenfolge erforderlich ist. In diesem Fall enthält pszOut nicht die konvertierte Zeichenfolge.

dwTimeMS

Art: DWORD

Das Zeitintervall in Millisekunden.

digits

Typ: int

Die maximale Anzahl signifikanter Ziffern, die in pszOut dargestellt werden sollen. Beispiele:

dwTimeMS	Zahlen	pszOut
34000	3	34 Sek.
34000	2	34 Sek.
34000	1	30 Sek
74000	3	1 Min. 14 Sek.
74000	2	1 Min. 10 Sek.
74000	1	1 Minute

Rückgabewert

Typ: int

Gibt die Anzahl der Zeichen in pszOut zurück, mit Ausnahme des abschließenden NULL-Zeichens .

Hinweise

Der in pszOut zurückgegebene Zeitwert ist immer im Format hh Stunden mm Minuten ss Sekunden. Zeiten, die vierundzwanzig Stunden überschreiten, werden nicht in Tage oder Monate konvertiert. Sekundenbruchteile werden ignoriert.

Beispiele

#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

Hinweis

Der shlwapi.h-Header definiert StrFromTimeInterval als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlwapi.h
Bibliothek	Shlwapi.lib
DLL	Shlwapi.dll (Version 4.71 oder höher)