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。
注意 針對 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 Professional 與 SP3 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003、具有 SP3 的 Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | winhttp.h |
| 程式庫 | Winhttp.lib |
| Dll | Winhttp.dll |
| 可轉散發套件 | Windows XP 和 Windows 2000 上的 WinHTTP 5.0 和 Internet Explorer 5.01 或更新版本。 |