SetLocalTime 函式 (sysinfoapi.h)

發行項
03/05/2024

設定目前的當地時間和日期。

語法

BOOL SetLocalTime(
  [in] const SYSTEMTIME *lpSystemTime
);

參數

[in] lpSystemTime

SYSTEMTIME 結構的指標，其中包含新的本機日期和時間。

系統會忽略 SYSTEMTIME 結構的 wDayOfWeek 成員。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。若要取得擴充的錯誤資訊，請呼叫 GetLastError。

備註

呼叫進程必須具有SE_SYSTEMTIME_NAME許可權。預設會停用此許可權。 SetLocalTime 函式會在變更當地時間之前啟用SE_SYSTEMTIME_NAME許可權，並在傳回之前停用許可權。如需詳細資訊，請參閱使用特殊許可權執行。

系統會在內部使用UTC。因此，當您呼叫 SetLocalTime 時，系統會使用目前的時區資訊來執行轉換，包括日光節約時間設定。請注意，系統會使用目前時間的日光節約時間設定，而不是您設定的新時間。因此，若要確保正確結果，請再次呼叫 SetLocalTime ，現在第一次呼叫已更新日光節約時間設定。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	sysinfoapi.h (包含 Windows.h)
程式庫	Kernel32.lib
DLL	Kernel32.dll