WinHttpTimeToSystemTime 函数 (winhttp.h)

WinHttpTimeToSystemTime 函数采用 HTTP 时间/日期字符串并将其转换为 SYSTEMTIME 结构。

语法

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

参数

[in] pwszTime

指向要转换的以 null 结尾的日期/时间字符串的指针。 此值必须使用 RFC2616第 3.3 节中定义的格式。

[out] pst

指向接收转换时间的 SYSTEMTIME 结构的指针。

返回值

如果成功，则返回 TRUE ，否则返回 FALSE 。 有关扩展的错误信息，请调用 GetLastError。 返回的错误代码包括：

注解

即使在异步模式下使用 WinHTTP， (即在 WinHttpOpen) 中设置了WINHTTP_FLAG_ASYNC时，此函数也会同步运行。 返回值指示成功或失败。 要获得更多的错误信息，请调用 GetLastError。

示例

此示例演示如何将 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);
    }

要求

另请参阅

关于 Microsoft Windows HTTP Services (WinHTTP)

WinHTTP 版本

WinHttpTimeFromSystemTime