Функция WinHttpTimeToSystemTime (winhttp.h)

Статья
08/27/2023

Функция WinHttpTimeToSystemTime принимает строку времени и даты HTTP и преобразует ее в структуру SYSTEMTIME .

Синтаксис

WINHTTPAPI BOOL WinHttpTimeToSystemTime(
  [in]  LPCWSTR    pwszTime,
  [out] SYSTEMTIME *pst
);

Параметры

[in] pwszTime

Указатель на преобразуемую строку даты и времени, завершаемую null. Это значение должно использовать формат, определенный в разделе 3.3 RFC2616.

[out] pst

Указатель на структуру SYSTEMTIME , которая получает преобразованное время.

Возвращаемое значение

Возвращает значение TRUE в случае успешного выполнения или FALSE в противном случае. Чтобы получить дополнительные сведения об ошибке, вызовите Метод GetLastError. Среди возвращаемых кодов ошибок:

Код ошибки	Описание
ERROR_WINHTTP_INTERNAL_ERROR	Произошла внутренняя ошибка.

Даже если WinHTTP используется в асинхронном режиме (то есть при установке WINHTTP_FLAG_ASYNC в WinHttpOpen), эта функция работает синхронно. Возвращаемое значение указывает на успех или сбой. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Примечание Для Windows XP и Windows 2000 см. раздел Требования во время выполнения начальной страницы WinHttp.

Примеры

В этом примере показано, как преобразовать дату в формате HTTP в структуру SYSTEMTIME .

    SYSTEMTIME  sTime;
    LPCWSTR     pwszTimeStr = L"Tue, 21 Nov 2000 01:06:53 GMT";

    // Convert the HTTP string to a SYSTEMTIME structure.
    if (!WinHttpTimeToSystemTime( pwszTimeStr, &sTime))
    {
        printf( "Error %u in WinHttpTimeToSystemTime.\n", GetLastError());
    }
    else
    {
        // Print the date.
        printf( "The U.S. formatted date is (%u/%u/%u)\n", 
                sTime.wMonth, sTime.wDay, sTime.wYear);
    }

Требования

Требование	Значение
Минимальная версия клиента	Windows XP, Windows 2000 Профессиональная с пакетом обновления 3 (SP3) [только классические приложения]
Минимальная версия сервера	Windows Server 2003, Windows 2000 Server с пакетом обновления 3 (SP3) [только классические приложения]
Целевая платформа	Windows
Header	winhttp.h
Библиотека	Winhttp.lib
DLL	Winhttp.dll
Распространяемые компоненты	WinHTTP 5.0 и Internet Обозреватель 5.01 или более поздней версии в Windows XP и Windows 2000.

См. также раздел

Сведения о службах HTTP Microsoft Windows (WinHTTP)

Версии WinHTTP

WinHttpTimeFromSystemTime

Поделиться через