RegRead -Autohotkey

Читает параметр из реестра.

RegRead, OutputVar, RootKey, SubKey [, ValueName]

Параметры

OutputVar	Имя переменной, куда будет помещено считанное значение. Если значение не может быть считано, переменная будет пустой и ErrorLevel будет установлен в 1.
RootKey	Имя корневого раздела. Возможные значения: HKEY_LOCAL_MACHINE (или HKLM), HKEY_USERS (или HKU), HKEY_CURRENT_USER (или HKCU), HKEY_CLASSES_ROOT (или HKCR), HKEY_CURRENT_CONFIG (или HKCC). Для доступа к удалённому реестру укажите вначале имя компьютера с двоеточием на конце, как в этом примере: \\workstation01:HKEY_LOCAL_MACHINE
SubKey	Имя подраздела (например, Software\SomeApplication).
ValueName	Имя параметра, чьё значение нужно прочитать. Если опущен или пустой, будет считан параметр, который в редакторе реестра отображается под именем "(По умолчанию)". Если ему не присвоено никакого значения, выходная переменная будет пустой и ErrorLevel равен 1.

ErrorLevel

Равен 1, если возникли проблемы, иначе 0.

Примечания

В настоящее время поддерживаются только следующие типы параметров: REG_SZ, REG_EXPAND_SZ, REG_MULTI_SZ, REG_DWORD, REG_BINARY.

Параметры REG_DWORD всегда выражаются в виде положительных десятичных чисел.

Из параметров типа REG_BINARY может быть считано не более 64 Кб данных, остальные не имеют таких ограничений.

При чтении REG_BINARY результатом будет строка шестнадцатеричных цифр. Например: REG_BINARY со значением 01,a9,ff,77 будет считан как 01A9FF77.

При чтении REG_MULTI_SZ все его компоненты оканчиваются переводом строки (`n). Если компонентов нет, выходная переменная будет пустой. Смотрите в описании команды FileSelectFile пример извлечения компонентов из выходной переменной.

Для работы сразу с множеством разделов или параметров используйте реестровый цикл, который описан в статье "Loop (registry)".

Подробности о работе с реестром удалённого компьютера смотрите в примечаниях в той же статье.

Примеры

RegRead, OutputVar, HKEY_LOCAL_MACHINE, SOFTWARE\Microsoft\Windows\CurrentVersion, ProgramFilesDir MsgBox, Файлы программ находятся в %OutputVar% ; Следующий пример определяет тип параметра (например, REG_SZ или REG_DWORD). MsgBox % RegKeyType("HKCU", "Environment", "TEMP") return RegKeyType(RootKey, SubKey, ValueName) ; Эта функция возвращает тип указанного параметра. { Loop, %RootKey%, %SubKey% if (A_LoopRegName = ValueName) return A_LoopRegType return "Ошибка" }

Автор перевода: YMP

Настоящее имя переводчика: Юрий Попов

Источник: http://www.script-coding.com/AutoHotkey/RegRead.html

Под редакцией ahk-wiki.ru от 21.08.19