RegWrite
実行制御 | GUI表示 | 演算・変数 | メモリ・DLL操作 | 文字列操作 |
キーボード | マウス | シェル | ウィンドウ | ウィンドウグループ
ステータスバー | コントロール | サウンド | ファイル | INIファイル |
レジストリ | 環境変数 | AutoHotkey | その他 | 設定関係 | オブジェクト
RegWrite[編集]
レジストリに値を書き込む。
RegWrite, ValueType, RootKey, SubKey [, ValueName, Value]
Parameters[編集]
引数名 | 説明 |
---|---|
ValueType | 値の種類。REG_SZ (文字列) REG_EXPAND_SZREG_MULTI_SZ 」 REG_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