SetLocalTime 関数 (sysinfoapi.h)

現在の現地時刻と日付を設定します。

構文

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

パラメーター

[in] lpSystemTime

新しいローカルの日付と時刻を含む SYSTEMTIME 構造体へのポインター。

SYSTEMTIME 構造体の wDayOfWeek メンバーは無視されます。

戻り値

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。 詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

呼び出し元のプロセスには、SE_SYSTEMTIME_NAME特権が必要です。 この特権は既定で無効になっています。 SetLocalTime 関数は、ローカル時刻を変更する前にSE_SYSTEMTIME_NAME特権を有効にし、戻る前に特権を無効にします。 詳細については、「特別な特権を使用して実行する」を参照してください。

システムは内部的に UTC を使用します。 したがって、 SetLocalTime を呼び出すと、システムは現在のタイム ゾーン情報を使用して、夏時間の設定を含む変換を実行します。 システムでは、設定する新しい時刻ではなく、現在の時刻の夏時間設定が使用されることに注意してください。 したがって、正しい結果を得るために、 SetLocalTime を 2 回目に呼び出します。最初の呼び出しで夏時間の設定が更新されました。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	sysinfoapi.h (Windows.h を含む)
Library	Kernel32.lib
[DLL]	Kernel32.dll

関連項目

GetLocalTime

GetSystemTime

現地時刻

SYSTEMTIME

SetSystemTimeAdjustment

時間関数