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 |