RegWrite

提供: AutoHotkey Wiki
移動: 案内検索

実行制御 | GUI表示 | 演算・変数 | メモリ・DLL操作 | 文字列操作 | キーボード | マウス | シェル | ウィンドウ | ウィンドウグループ
ステータスバー | コントロール | サウンド | ファイル | INIファイル | レジストリ | 環境変数 | AutoHotkey | その他 | 設定関係 | オブジェクト

RegWrite[編集]

レジストリに値を書き込む。

RegWrite, ValueType, RootKey, SubKey [, ValueName, Value]

Parameters[編集]

引数名 説明
ValueType 値の種類。
REG_SZ(文字列) REG_EXPAND_SZREG_MULTI_SZREG_DWORD(整数) REG_BINARYのどれか。
RootKey HKEY_LOCAL_MACHINE HKEY_USERS HKEY_CURRENT_USER HKEY_CLASSES_ROOT HKEY_CURRENT_CONFIGのどれか。 HKLMのような短縮名も可能。
リモートのレジストリにアクセスしたい場合、 \\workstation01:HKEY_LOCAL_MACHINEのようにコンピュータ名と :をつける。
SubKey サブキーの名前
ValueName 値の名前。
省略時は、サブキーの規定の値になる。
Value 書き込む値。
省略時は、ValueTypeによって空か 0になる。

ErrorLevel[編集]

成功時は 0、失敗時は 1

A_LastError にOSのGetLastError()関数を呼び出した結果を格納。

AHKL [v1.1.04+] このコマンドは失敗した場合に例外をスローすることができる。詳細は実行時エラーを参照。

Remarks[編集]

レジストリへの書き込みは危険を伴うので、慎重に行うこと。

ValueTypeがREG_DWORDの場合、Valueは符号なし整数で指定する。16進数での指定も可能。

REG_BINARYの場合、Valueは 01A9FF77......のような16進数列で指定する。

REG_MULTI_SZの場合、ValueはLF(`n)区切りの文字列で指定する。
一番最後の`nは無視される。
空項目は許されないので、`nを複数続けて含んではいけない。

64Kを超えるREG_BINARYとREG_MULTI_SZの値はv1.1.10.01以降でサポートされた。
以前のバージョンではこの上限を超えた場合、最初の64KBだけが書き込まれる。

Loop (レジストリ) を使用すれば、複数のキーに同じ操作を行うことができる。

レジストリ内の64ビット精度の値を読み書きするには ここ を参考にする。

Related[編集]

RegDelete, RegRead, Loop (レジストリ), SetRegView, IniWrite

Example(s)[編集]

RegWrite, REG_SZ, HKEY_LOCAL_MACHINE, SOFTWARE\TestKey, MyValueName, Test Value
RegWrite, REG_BINARY, HKEY_CURRENT_USER, Software\TEST_APP, TEST_NAME, 01A9FF77
RegWrite, REG_MULTI_SZ, HKEY_CURRENT_USER, Software\TEST_APP, TEST_NAME, Line1`nLine2