WinHttpTimeFromSystemTime, fonction (winhttp.h)

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.

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.

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

Voir aussi

À propos des services HTTP Microsoft Windows (WinHTTP)

WinHTTP Versions

WinHttpTimeToSystemTime