SetSystemTime 関数 (sysinfoapi.h)

  • [アーティクル]

現在のシステム時刻と日付を設定します。 システム時刻は協定世界時 (UTC) で表されます。

構文

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

パラメーター

[in] lpSystemTime

新しいシステムの日付と時刻を含む SYSTEMTIME 構造体へのポインター。

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

戻り値

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

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

解説

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

要件

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

関連項目

GetSystemTime

SYSTEMTIME

SetSystemTimeAdjustment

システム時刻

時間関数