StrFromTimeIntervalW-Funktion (shlwapi.h)

Konvertiert ein in Millisekunden angegebenes Zeitintervall in eine Zeichenfolge.

Syntax

int StrFromTimeIntervalW(
  [out] PWSTR pszOut,
        UINT  cchMax,
        DWORD dwTimeMS,
        int   digits
);

Parameter

[out] pszOut

Typ: PTSTR

Ein Zeiger auf einen Puffer, der bei erfolgreicher Rückgabe dieser Funktion die konvertierte Zahl empfängt.

cchMax

Typ: UINT

Die Größe von pszOut in Zeichen. Wenn cchMax auf Null festgelegt ist, gibt StrFromTimeInterval die Mindestgröße des Zeichenpuffers zurück, die 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 Sekunden
34000	2	34 Sekunden
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, ohne das beendende NULL-Zeichen .

Hinweise

Der in pszOut zurückgegebene Zeitwert hat immer die Form hh Stunden mm Minuten ss Sekunden. Zeiten, die vierundzwanzig Stunden überschreiten, werden nicht in Tage oder Monate umgewandelt. 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 automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
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)