WinHttpTimeFromSystemTime-Funktion (winhttp.h)

Artikel
08/27/2023

Die WinHttpTimeFromSystemTime-Funktion formatiert ein Datum und eine Uhrzeit gemäß der HTTP-Version 1.0-Spezifikation.

Syntax

WINHTTPAPI BOOL WinHttpTimeFromSystemTime(
  [in]  const SYSTEMTIME *pst,
  [out] LPWSTR           pwszTime
);

Parameter

[in] pst

Ein Zeiger auf eine SYSTEMTIME-Struktur , die das zu formatierende Datum und die Uhrzeit enthält.

[out] pwszTime

Ein Zeiger auf einen Zeichenfolgenpuffer, der das formatierte Datum und die formatierte Uhrzeit empfängt. Der Puffer sollte der Größe von WINHTTP_TIME_FORMAT_BUFSIZE in Bytes entsprechen.

Rückgabewert

Gibt TRUE zurück, wenn der Vorgang erfolgreich war, oder andernfalls FALSE . Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. Zu den Fehlercodes zählen die folgenden.

Fehlercode	BESCHREIBUNG
ERROR_WINHTTP_INTERNAL_ERROR	Ein interner Fehler ist aufgetreten.

Hinweise

Auch wenn WinHTTP im asynchronen Modus verwendet wird (d. h. wenn WINHTTP_FLAG_ASYNC in WinHttpOpen festgelegt wurde), arbeitet diese Funktion synchron. Der Rückgabewert weist auf Erfolg oder Fehler hin. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweis Informationen zu Windows XP und Windows 2000 finden Sie im Abschnitt Laufzeitanforderungen der WinHTTP-Startseite .

Beispiele

Der folgende Codebeispielcode zeigt, wie eine SYSTEMTIME-Struktur in eine Zeichenfolge konvertiert wird, die die Zeit im HTTP-Format enthält.

    SYSTEMTIME  sTime;
    LPWSTR      pwszTimeStr;

    // Get the current time.
    GetSystemTime(&sTime);

    // Allocate memory for the string.
    // Note: WINHTTP_TIME_FORMAT_BUFSIZE is a byte count.
    //       Therefore, you must divide the array by
    //       sizeof WCHAR to get the proper string length.
    pwszTimeStr = new WCHAR[WINHTTP_TIME_FORMAT_BUFSIZE/sizeof(WCHAR)];

    // Convert the current time to HTTP format.
    if(!WinHttpTimeFromSystemTime( &sTime, pwszTimeStr))
    {
        printf( "Error %u in WinHttpTimeFromSystemTime.\n", GetLastError());
    }
    else
    {
        // Print the time.
        printf("Current time is (%S)\n", pwszTimeStr);
    }

    // Free the memory.
    delete [] pwszTimeStr;

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional mit SP3 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003, Windows 2000 Server mit SP3 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winhttp.h
Bibliothek	Winhttp.lib
DLL	Winhttp.dll
Verteilbare Komponente	WinHTTP 5.0 und Internet Explorer 5.01 oder höher unter Windows XP und Windows 2000.

Weitere Informationen

Informationen zu Microsoft Windows HTTP-Diensten (WinHTTP)

WinHTTP-Versionen

WinHttpTimeToSystemTime

Freigeben über