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

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

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

Ниже разобраны оба способа регистрации, проверка результата, работа с 32- и 64-разрядными версиями и типичные ошибки с их причинами.

Как определить, какой тип DLL у вас

Перед регистрацией важно понять, что за библиотека у вас в руках, потому что способы подключения не взаимозаменяемы. COM-DLL создаёт объект через механизм Windows (в 1С это выглядит как Новый COMОбъект("Имя.Объекта")), и такая библиотека обязана быть прописана в реестре. Внешняя компонента 1С по технологии Native API поставляется обычно в zip-архиве (макете) и подключается программно из кода конфигурации — запись в реестре ей не нужна.

Простой признак: если поставщик компоненты дал инструкцию «выполните regsvr32» или в поставке есть файл с расширением .dll и упоминание ProgID вида «AddIn.Scanner» — это COM. Если компонента распространяется как zip-файл, который добавляется в макет конфигурации, — это Native API, и regsvr32 для неё бесполезен.

Регистрация COM-DLL через regsvr32

Стандартный способ — утилита regsvr32, встроенная в Windows. Запускать её нужно из командной строки, открытой от имени администратора: иначе запись в ветку реестра HKEY_LOCAL_MACHINE будет отклонена, хотя ошибка может выглядеть по-разному. Положите DLL в постоянную папку (например, C:\Components), потому что после регистрации перемещать или удалять файл нельзя — реестр хранит полный путь.

regsvr32 "C:\Components\MyComponent.dll"

После выполнения появится диалог «DllRegisterServer in ... succeeded» — это признак успешной регистрации. Если вместо этого ошибка 0x80070005 — не хватило прав, перезапустите командную строку с повышением. Ошибка 0x80004005 часто означает, что DLL зависит от других библиотек, которых нет в системе, либо файл повреждён.

1. 1
   Скопируйте DLL в постоянную папку без русских букв и пробелов в пути
2. 2
   Откройте командную строку от имени администратора
3. 3
   Выполните regsvr32 с полным путём к DLL (для 32-битной DLL на 64-битной ОС — через SysWOW64)
4. 4
   Дождитесь сообщения об успешной регистрации
5. 5
   Перезапустите клиент 1С и проверьте создание объекта

Разрядность: 32 и 64 бита

Самая частая причина «не работает после регистрации» — несовпадение разрядности. Клиент 1С бывает 32-разрядным и 64-разрядным, и COM-объект он может загрузить только своей разрядности. На 64-разрядной Windows 32-битные DLL регистрируются отдельно — через regsvr32 из папки SysWOW64, а не System32 (названия папок исторически перепутаны: в System32 лежат 64-битные компоненты).

C:\Windows\SysWOW64\regsvr32.exe "C:\Components\MyComponent.dll"

Если вы зарегистрировали 32-битную DLL обычным regsvr32, она попадёт в 64-битный раздел реестра, и 32-битный клиент 1С её не увидит. Проверить разрядность самой DLL можно, открыв её в просмотрщике PE-заголовков или косвенно — по документации поставщика. Если доступна только 32-битная версия компоненты, а сервер 1С 64-разрядный, объект создают на стороне клиента или на отдельном 32-битном процессе.

Подключение внешних компонент 1С (Native API)

Для компонент Native API регистрация в Windows не требуется. Компонента хранится в конфигурации как zip-макет и подключается кодом: сначала УстановитьВнешнююКомпоненту("ОбщийМакет.ИмяМакета"), затем ПодключитьВнешнююКомпоненту("ОбщийМакет.ИмяМакета", "Имя", ТипВнешнейКомпоненты.Native), после чего создаётся объект Новый("AddIn.Имя.Объект"). В пользовательском режиме платформа сама предложит установить компоненту при первом обращении.

В файловой базе установка происходит в папку профиля пользователя, в клиент-серверном варианте — на сервере 1С, если компонента используется в серверном коде. Убедитесь, что в zip-архиве есть версии под нужные платформы (Windows x86, x64, при необходимости Linux), иначе на части рабочих мест компонента не подключится.

Проверка результата

После регистрации COM-DLL проверьте её из самой 1С: выполните в консоли кода создание объекта с нужным ProgID. Если строка Объект = Новый COMОбъект("Vendor.Component") выполнилась без исключения — регистрация успешна и разрядность совпала. Ошибка «Недопустимая строка с указанием класса» означает, что ProgID не найден в реестре нужной разрядности.

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

Большинство проблем сводится к четырём причинам: нет прав администратора, неверная разрядность, файл перемещён после регистрации, отсутствуют зависимые библиотеки (например, Visual C++ Redistributable нужной версии). Последнюю причину видно по ошибке «модуль не найден» при заведомо существующем файле — regsvr32 имеет в виду не саму DLL, а её зависимость.

Для снятия регистрации используется команда regsvr32 /u "путь\файл.dll" — её нужно выполнить перед удалением или переносом библиотеки. После любых манипуляций перезапускайте клиент 1С: COM-информация кэшируется процессом.

Частые вопросы