↑  ←  Описание функции


RegRead

Возвращает значение параметра реестра.

RegRead ( "keyname", "valuename" )

Параметры

keyname Раздел реестра.
valuename Имя параметра.

Возвращаемое значение

Успех:Возвращает значение запрошенного параметра. @extended содержит тип параметра $REG_... . Эти типы определены в файле для включения "Constants.au3".
Ошибка:Возвращает пустую строку и устанавливает значение @error равным:
1 - Не удалось открыть указанный раздел
2 - Не удалось открыть указанный основной раздел
3 - Не удалось подключиться к удаленному реестру
-1 - Не удалось открыть указанный параметр
-2 - Тип параметра не поддерживается

Примечания

Параметр keyname должен начинаться с "HKEY_LOCAL_MACHINE" ("HKLM"), "HKEY_USERS" ("HKU"), "HKEY_CURRENT_USER" ("HKCU"), "HKEY_CLASSES_ROOT" ("HKCR") или "HKEY_CURRENT_CONFIG" ("HKCC").

При работе в 64-битной Windows, если вы хотите получить значение параметра в 64-битной среде, вы должны указать суффикс HK ... с 64, например, HKLM64.

AutoIt поддерживает типы параметров REG_BINARY, REG_SZ, REG_MULTI_SZ, REG_EXPAND_SZ и REG_DWORD. Смотрите таблицу
Для доступа к параметру (По умолчанию) используйте "" (пустую строку) в качестве параметра valuename.

При чтении параметров типа REG_BINARY результат возвращается в бинарном виде (в предыдущих версиях возвращалась шестнадцатеричная строка).

При чтении параметров типа REG_MULTI_SZ многострочные данные разделяются символом @LF - используйте функцию StringSplit(..., @LF), чтобы получить массив, содержащий отдельные строки.

Возможен также доступ к удалённому реестру при использовании имени раздела в виде \\computername\keyname. Для использования этой возможности нужны соответствующие права доступа.

См. также

RegDelete, RegWrite, StringSplit

Пример

$sPath = RegRead("HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion", "ProgramFilesDir")
MsgBox(0, 'Сообщение', 'Путь к программной папке: ' & $sPath & @LF & 'Тип данных: ' & @extended)