WinHttpTimeFromSystemTime, fonction (winhttp.h)

Article
08/27/2023

La fonction WinHttpTimeFromSystemTime met en forme une date et une heure conformément à la spécification HTTP version 1.0.

Syntaxe

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

Paramètres

[in] pst

Pointeur vers une structure SYSTEMTIME qui contient la date et l’heure à mettre en forme.

[out] pwszTime

Pointeur vers une mémoire tampon de chaîne qui reçoit la date et l’heure mises en forme. La mémoire tampon doit être égale à la taille, en octets, de WINHTTP_TIME_FORMAT_BUFSIZE.

Valeur retournée

Retourne TRUE en cas de réussite, ou FALSE dans le cas contraire. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError. Les codes d’erreur incluent les éléments suivants.

Code d'erreur	Description
ERROR_WINHTTP_INTERNAL_ERROR	Une erreur interne s'est produite.

Remarques

Même lorsque WinHTTP est utilisé en mode asynchrone (autrement dit, quand WINHTTP_FLAG_ASYNC a été défini dans WinHttpOpen), cette fonction fonctionne de manière synchrone. La valeur de retour indique la réussite ou l’échec. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Note Pour Windows XP et Windows 2000, consultez la section Conditions requises pour l’exécution de la page de démarrage WinHTTP.

Exemples

L’exemple de code suivant montre comment convertir une structure SYSTEMTIME en une chaîne qui contient l’heure au format HTTP.

    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;

Configuration requise


Client minimal pris en charge	Windows XP, Windows 2000 Professionnel avec SP3 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003, Windows 2000 Server avec SP3 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winhttp.h
Bibliothèque	Winhttp.lib
DLL	Winhttp.dll
Composant redistribuable	WinHTTP 5.0 et Internet Explorer 5.01 ou version ultérieure sur Windows XP et Windows 2000.

Voir aussi

À propos des services HTTP Microsoft Windows (WinHTTP)

WinHTTP Versions

WinHttpTimeToSystemTime

Partager via