SetLocalTime

Declare Function Api_SetLocalTime& Lib "kernel32" Alias "SetLocalTime" (lpSytemTime As SYSTEMTIME)

Declare Function SetLocalTime Lib "kernel32" Alias "SetLocalTime" (lpSystemTime As SYSTEMTIME) As Long

現在のローカル日時を設定する。

パラメータ
lpSystemTime
    設定するべき現在のローカル日時を保持している、1 個の SYSTEMTIME 構造体へのポインタを指定する。
    この構造体の wDayOfWeek メンバは無視される。

戻り値
    関数が成功すると、0 以外の値が返る。
    関数が失敗すると、0 が返る。拡張エラー情報を取得するには、GetLastError 関数を使う。

解説
    Windows NT/2000：これらのシステムは、内部で世界協定時刻（UTC）を使っている。したがって、SetLocalTime 関数を呼び出すと、

    Windows NT/2000 は夏時間の設定も含む現在のタイムゾーン情報を使って、変換を実行する。

    Windows NT/2000 が、設定するべき新しい時刻ではなく、現在の時刻に関連する夏時間情報を使うことに注意すること。

    したがって、SetLocalTime 関数をもう一度呼び出すと、新しい時刻に関連する夏時間情報が適用され、正しい結果が得られることが保証

    される。
    Windows NT/2000：SetLocalTime 関数は、ローカル時刻を変更する前に、SE_SYSTEMTIME_NAME 特権を有効にする。

    この特権は、既定では無効になっているこの特権を割り当てるには、AdjustTokenPrivileges 関数を使う。