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
