Как зарегистрировать DLL для 1С через regsvr32

Компоненты 1С — внешние печатные формы, драйверы торгового оборудования, COM-объекты интеграции — часто поставляются в виде DLL-библиотек, которые Windows должна «узнать» до первого вызова. Пока библиотека не прописана в системном реестре, 1С при попытке создать COM-объект выдаёт ошибку вида «Невозможно создать объект» или «Класс не зарегистрирован». Стандартный способ регистрации — системная утилита regsvr32.

Регистрация сводится к одной команде, но на практике большинство проблем связано не с самой командой, а с окружением: разрядностью Windows и 1С, правами пользователя, путём к файлу и зависимостями самой библиотеки. Ниже разобран полный порядок действий — от подготовки до проверки результата и устранения типовых ошибок.

Материал ориентирован на администраторов и пользователей, которым нужно подключить драйвер сканера штрихкодов, кассового аппарата, компоненту криптографии или любую другую DLL к платформе 1С:Предприятие.

Что такое regsvr32 и зачем регистрировать DLL для 1С

Regsvr32 — встроенная утилита Windows, которая вызывает из DLL функцию DllRegisterServer и записывает сведения о COM-классах библиотеки в системный реестр: идентификаторы CLSID, ProgID, пути к файлу. После этого любое приложение, включая 1С, может создать объект по имени, например через Новый COMОбъект("AddIn.Scanner").

Без регистрации Windows не знает, где лежит библиотека и какие классы она экспортирует. Типичный сценарий в 1С: обработка подключения торгового оборудования обращается к драйверу, получает отказ «Класс не зарегистрирован» — и единственное, что требуется, это зарегистрировать соответствующую DLL.

Важно понимать: regsvr32 работает только с COM-библиотеками (ActiveX). Обычные DLL без точки входа DllRegisterServer зарегистрировать нельзя — утилита вернёт ошибку, и это нормальное поведение, а не поломка файла.

Подготовка: права, разрядность и расположение файла

Перед регистрацией убедитесь в трёх вещах. Во-первых, у вас должны быть права локального администратора: regsvr32 пишет в ветку реестра HKEY_LOCAL_MACHINE, и без повышенных прав команда завершится ошибкой. Во-вторых, определите разрядность DLL — 32 или 64 бита. В-третьих, положите файл в постоянное расположение: после регистрации перемещать или удалять его нельзя, иначе ссылки в реестре станут битыми.

Хорошая практика — складывать регистрируемые библиотеки в отдельный каталог без пробелов и кириллицы в пути, например C:\1C_Components\. Пробелы сами по себе не мешают (путь берётся в кавычки), но кириллица иногда вызывает проблемы у старых компонентов.

Узнать разрядность DLL можно сторонними утилитами (например, просмотром заголовков PE-файла) или косвенно — из документации поставщика драйвера. Правило простое: разрядность DLL должна совпадать с разрядностью клиентского приложения 1С, которое будет её вызывать.

Пошаговая регистрация DLL через regsvr32

Базовая процедура одинакова для любой COM-библиотеки. Откройте командную строку от имени администратора: нажмите «Пуск», введите cmd, щёлкните правой кнопкой по «Командная строка» и выберите «Запуск от имени администратора». Затем выполните команду регистрации.

1. 1
   Скопируйте DLL в постоянный каталог, например C:\1C_Components\
2. 2
   Откройте командную строку от имени администратора
3. 3
   Выполните: regsvr32 "C:\1C_Components\driver.dll"
4. 4
   Дождитесь окна об успешном выполнении DllRegisterServer
5. 5
   Перезапустите клиент 1С и проверьте создание COM-объекта

regsvr32 "C:\1C_Components\driver.dll"

Успешный результат — диалоговое окно «DllRegisterServer in ... succeeded» или аналогичное сообщение на русском языке. Если команда запускается из скрипта и окна нежелательны, добавьте ключ /s (тихий режим), но в этом случае ошибки тоже будут скрыты — проверяйте код возврата.

Отмена регистрации

Если библиотеку нужно убрать — например, перед установкой новой версии драйвера — используйте ключ /u: regsvr32 /u "C:\1C_Components\driver.dll". Утилита вызовет DllUnregisterServer и удалит записи из реестра. После этого файл можно перемещать или удалять.

Разрядность: regsvr32 в 64-разрядной Windows

Главный подводный камень темы. В 64-разрядной Windows существуют две копии regsvr32: 64-битная в C:\Windows\System32 и 32-битная в C:\Windows\SysWOW64. Названия каталогов контринтуитивны: System32 содержит 64-битные утилиты, а SysWOW64 — 32-битные.

Большинство драйверов торгового оборудования для 1С — 32-разрядные, потому что долгое время клиент 1С был только 32-битным. Если вы запускаете 32-битный клиент 1С на 64-разрядной Windows, регистрировать DLL нужно явно через 32-битную версию утилиты:

C:\Windows\SysWOW64\regsvr32.exe "C:\1C_Components\driver.dll"

Если же используется 64-разрядный клиент 1С, потребуется 64-битная версия драйвера, и регистрируется она обычной командой regsvr32 из System32. Несовпадение разрядности — самая частая причина ситуации, когда «всё зарегистрировалось успешно, а 1С объект не видит»: записи оказались не в том разделе реестра.

Типичные ошибки regsvr32 и их устранение

Ошибка 0x80004005 при регистрации почти всегда означает нехватку прав — командная строка запущена без повышения. Закройте окно и перезапустите его от имени администратора. Если права есть, а ошибка остаётся, проверьте, не блокирует ли файл антивирус или политика безопасности.

Сообщение «Модуль загружен, но точка входа DllRegisterServer не найдена» говорит о том, что файл не является COM-библиотекой. Такие DLL подключаются в 1С иначе — как внешние компоненты по технологии Native API через ПодключитьВнешнююКомпоненту(), и regsvr32 здесь не поможет.

Ошибка «Не удалось загрузить модуль» при существующем файле обычно означает отсутствие зависимостей: сама DLL требует других библиотек (например, Visual C++ Redistributable), которых нет в системе. Установите пакет зависимостей от поставщика и повторите регистрацию.

Проверка результата и где регистрировать: клиент или сервер

После успешной регистрации перезапустите 1С и проверьте создание объекта. Быстрый способ — выполнить в консоли кода или через обработку: Ком = Новый COMОбъект("ProgID.Компоненты"). Если объект создался без исключения — регистрация работает.

Критично понимать контекст выполнения. Если код вызывается на клиенте (типично для торгового оборудования), DLL должна быть зарегистрирована на каждом рабочем месте. Если код выполняется на сервере 1С — регистрировать нужно на сервере под той разрядностью, под которой работает агент сервера. Регистрация на одной машине не распространяется на другие.

Для массовой регистрации на нескольких рабочих местах удобно подготовить bat-файл с явным вызовом нужной версии regsvr32 и распространить его через групповые политики или систему управления. В скрипте используйте тихий режим /s и логируйте код возврата, чтобы отловить машины, где регистрация не прошла.

FAQ