StrFromTimeIntervalW-Funktion (shlwapi.h)

Artikel
11/20/2024

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, wenn diese Funktion erfolgreich zurückgegeben wird, 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, der zum Speichern der konvertierten Zeichenfolge erforderlich ist. In diesem Fall enthält pszOut- nicht die konvertierte Zeichenfolge.

dwTimeMS

Typ: DWORD-

Das Zeitintervall in Millisekunden.

digits

Typ: int

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

dwTimeMS	Ziffern	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 Min.

Rückgabewert

Typ: int

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

Bemerkungen

Der in pszOut- zurückgegebene Zeitwert befindet sich immer in der Form hh Stunden mm Minuten ss Sekunden. Zeiten, die 24 Stunden überschreiten, werden nicht in Tage oder Monate konvertiert. Bruchzahlen von Sekunden 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

Anmerkung

Der Header "shlwapi.h" 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 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

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	shlwapi.h
Library	Shlwapi.lib
DLL-	Shlwapi.dll (Version 4.71 oder höher)

Freigeben über