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

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

Регистрация выполняется штатной утилитой Windows regsvr32, либо средствами самой 1С, если компонента поставляется в виде макета внешней компоненты. Процедура занимает несколько минут, но требует прав администратора и понимания разрядности системы: большинство сбоев связано именно с попыткой зарегистрировать 32-битную DLL не той версией regsvr32 или без повышенных прав.

Что нужно подготовить перед регистрацией

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

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

Проверьте, что у вашей учётной записи есть права администратора, либо заранее договоритесь с системным администратором. Регистрация COM-компоненты записывает сведения в ветку реестра HKEY_CLASSES_ROOT, и без повышенных прав regsvr32 завершится ошибкой.

Как определить разрядность DLL и клиента 1С

Разрядность клиента 1С видна в окне «О программе»: откройте меню «Справка» — «О программе» и посмотрите версию платформы. Если указано «8.3.x (x86-64)» — это 64-битный клиент, если просто «8.3.x» без пометки — обычно 32-битный. Точную разрядность также показывает диспетчер задач: у 32-битных процессов в старых версиях Windows рядом с именем стоит пометка «32 бита».

Разрядность самой DLL определить сложнее. Простой способ — открыть файл в любом просмотрщике PE-заголовков или воспользоваться утилитой от разработчика компоненты. На практике проще ориентироваться на документацию поставщика: компоненты торгового оборудования и сканеров исторически чаще 32-битные, тогда как современные компоненты по технологии Native API часто поставляются в обеих разрядностях.

Регистрация DLL через regsvr32: пошаговая инструкция

Стандартный способ регистрации — утилита regsvr32, входящая в состав Windows. Скопируйте файл DLL в постоянную папку, например в каталог установки оборудования или в отдельную папку вроде C:\Components. Не регистрируйте библиотеку из временных папок, рабочего стола или каталога загрузок: путь к файлу фиксируется в реестре, и после перемещения или удаления файла компонента перестанет работать.

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

regsvr32 "C:\Components\MyComponent.dll"

При успешной регистрации появится диалоговое окно с сообщением «DllRegisterServer в файле ... выполнена успешно». Если вместо этого появилась ошибка — запомните её код: по нему определяется причина сбоя (об этом ниже).

1. 1
   Скопируйте DLL в постоянную папку с понятным путём без кириллицы и пробелов в идеале
2. 2
   Определите разрядность DLL и клиента 1С
3. 3
   Откройте командную строку от имени администратора
4. 4
   Выполните regsvr32 с полным путём к файлу (для 32-битной DLL на 64-битной Windows используйте C:\Windows\SysWOW64\regsvr32.exe)
5. 5
   Убедитесь, что появилось сообщение об успешной регистрации
6. 6
   Перезапустите 1С и проверьте подключение компоненты

Особенности разрядности: SysWOW64 против System32

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

Правило простое: разрядность regsvr32 должна совпадать с разрядностью регистрируемой DLL. Регистрируете 32-битную компоненту для 32-битного клиента 1С — вызывайте C:\Windows\SysWOW64\regsvr32.exe. Регистрируете 64-битную — используйте C:\Windows\System32\regsvr32.exe.

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

Если запустить regsvr32 просто по имени из командной строки на 64-битной системе, по умолчанию вызовется 64-битная версия. Попытка зарегистрировать ей 32-битную DLL обычно завершается ошибкой о несоответствии разрядности. Поэтому при сомнениях всегда указывайте полный путь к нужной версии утилиты.

Регистрация средствами самой 1С и Native API

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

Типовые драйверы торгового оборудования, входящие в поставку конфигураций, также часто устанавливаются и регистрируются автоматически при первом обращении из интерфейса настройки оборудования. В этом случае ручная регистрация не нужна — достаточно прав пользователя на запись в профиль и, при необходимости, одобрения установки.

Ручная регистрация через regsvr32 нужна для классических COM-компонентов: старых драйверов сканеров, библиотек криптографии, самописных COM-объектов, которые подключаются методом СоздатьОбъект или через COMСоединитель-подобные механизмы.

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

Ошибка 0x80070005 (отказано в доступе) означает, что командная строка запущена без прав администратора. Закройте окно и перезапустите его через «Запуск от имени администратора». Если права ограничены политикой организации, регистрацию должен выполнить системный администратор.

Ошибка 0x80004005 — универсальный код сбоя. Чаще всего причины те же: недостаток прав, неверный путь к файлу, кириллица или пробелы в пути при кривой реализации компоненты, либо отсутствие зависимых библиотек, от которых зависит DLL. Проверьте путь, перенесите файл в простую папку и повторите попытку.

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

Ошибка о несоответствии разрядности («не является приложением Win32» или похожие формулировки) указывает, что вызвана regsvr32 не той разрядности. Используйте SysWOW64 для 32-битных и System32 для 64-битных библиотек.

Как проверить результат и отменить регистрацию

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

Если подключение прошло без исключения и объект создан, регистрация работает. Если 1С сообщает, что компонента не найдена, вернитесь к проверке разрядности и убедитесь, что регистрация действительно завершилась успешным сообщением, а не ошибкой.

Для отмены регистрации используется та же утилита с ключом /u. Это полезно при замене версии компоненты или при переносе файла в другую папку: сначала снимите регистрацию со старого пути, затем зарегистрируйте файл из нового расположения.

regsvr32 /u "C:\Components\MyComponent.dll"

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