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 |