winHttpTimeFromSystemTime 函式 (winHTTP.h)

WinHttpTimeFromSystemTime函式會根據 HTTP 1.0 版規格來格式化日期和時間。

語法

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

參數

[in] pst

SYSTEMTIME結構的指標，其中包含要格式化的日期和時間。

[out] pwszTime

接收格式化日期和時間之字串緩衝區的指標。 緩衝區應該等於WINHTTP_TIME_FORMAT_BUFSIZE的大小，以位元組為單位。

傳回值

如果成功，則傳回 TRUE ，否則傳回 FALSE 。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。 錯誤碼包括下列各項。

錯誤碼	描述
ERROR_WINHTTP_INTERNAL_ERROR	發生內部錯誤。

備註

即使 WinHTTP 用於非同步模式 (亦即，在WinHttpOpen) 中設定WINHTTP_FLAG_ASYNC時，此函式仍會同步運作。 傳回值表示成功或失敗。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。

注意 針對 Windows XP 和 Windows 2000，請參閱 WinHTTP 起始頁的 執行時間需求 一節。

 

範例

下列程式碼範例程式碼示範如何將 SYSTEMTIME 結構轉換為包含 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;

規格需求

最低支援的用戶端	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 或更新版本。

另請參閱

關於 Microsoft Windows HTTP Services (WinHTTP)

WinHTTP 版本

WinHttpTimeToSystemTime