Перейти на главную страничку сайта (список статей, файлы для скачивания)

ФОРУМ (здесь можно обсудить эту статью, а также саму программу AutoHotkey и проблемы её использования)

Проект перевода документации AutoHotkey: перечень переведённых статей и статей в работе.

Оригинал статьи в AutoHotkey.chm: "RegWrite", в содержании - "Registry Management" - "RegWrite", v1.0.46.09.

Ник переводчика: YMP.

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

RegWrite

Записывает параметр в реестр.

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

Параметры

ValueType Тип записываемого параметра. Возможные значения: REG_SZ, REG_EXPAND_SZ, REG_MULTI_SZ, REG_DWORD, REG_BINARY.
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). Если раздел не существует, он будет создан (вместе со своими родительскими разделами, если необходимо). Если SubKey оставлен пустым, запись произойдёт прямо в корневой раздел (хотя некоторые операционные системы могут отказаться писать в HKEY_CURRENT_USER).
ValueName Имя параметра реестра, который будет записан. Если опущен или пустой, будет записан параметр, который в редакторе реестра отображается под именем "(По умолчанию)".
Value Значение для записываемого параметра. Если опущено, считается пустой строкой либо нулём, в зависимости от типа параметра. Если пишется длинный текст, он может быть разбит на более короткие строки и оформлен в виде секции продолжения (см. описание этого приёма в статье "Скрипты"), что может сделать более удобным чтение кода скрипта.

ErrorLevel

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

Примечания

Значение параметров типа REG_DWORD должно лежать между -2147483648 и 4294967295 (0xFFFFFFFF).

Параметры REG_BINARY и REG_MULTI_SZ допускают запись до 64 Кб данных, остальные не имеют ограничений. Однако в Windows 95/98/ME этот предел действует для всех типов параметров. Когда это ограничение действует, данные, находящиеся после 64 Кб, не будут записаны. Другими словами, только первые 64 Кб очень длинной строки будут сохранены в реестре.

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

При записи REG_MULTI_SZ вы должны отделять каждый компонент от следующего символом перевода строки (`n). Последний компонент также можно (но необязательно) завершить переводом строки. Пустые компоненты не допускаются. Другими словами, не указывайте два перевода строки подряд (`n`n), поскольку результатом будет запись в реестр значения более короткого, чем ожидалось. Замечание: Windows 95 не поддерживает параметры REG_MULTI_SZ.

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

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

Примеры

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, Строка1`nСтрока2

Перейти на главную страничку сайта (список статей, файлы для скачивания)

© 2007 http://www.script-coding.com При любом использовании материалов сайта обязательна ссылка на него как на источник информации, а также сохранение целостности и авторства материалов.