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

COM-объекты в 1С используются для подключения внешних компонентов, обмена данными между базами через COM-соединитель (V83.COMConnector), интеграции с офисными приложениями и сторонними системами. Прежде чем объект станет доступен в коде через Новый COMОбъект(...), его библиотеку необходимо зарегистрировать в операционной системе Windows.

Регистрация сводится к записи сведений о библиотеке (DLL или OCX) в системный реестр: Windows сохраняет путь к файлу, его ProgID и CLSID, после чего любое приложение, включая платформу 1С, может создать экземпляр объекта по имени. Выполняется регистрация штатной утилитой regsvr32, но на практике большинство проблем связано не с самой командой, а с разрядностью, правами доступа и версией библиотеки.

Ниже разобран полный порядок действий: от подготовки файла до проверки работоспособности объекта из кода 1С, а также типовые ошибки и способы их устранения.

Что понадобится перед регистрацией

Для успешной регистрации нужны три условия: сам файл библиотеки (DLL или OCX), права администратора на компьютере и понимание разрядности компонентов. Без прав администратора regsvr32 не сможет внести записи в системные ветки реестра, и команда завершится ошибкой.

Файл библиотеки следует разместить в постоянном каталоге, из которого его не удалят и не переместят: после регистрации Windows хранит абсолютный путь, и при перемещении файла объект перестанет создаваться. Подходящие варианты — каталог установки 1С, Program Files или отдельная папка компонентов. Рабочий стол и временные папки для этого не подходят.

Отдельно проверьте источник библиотеки. Регистрация DLL, полученной из недоверенного источника, фактически означает запуск чужого кода с высокими привилегиями внутри процессов 1С. Используйте компоненты от известных поставщиков и проверяйте цифровую подпись файла, если она заявлена.

Определяем разрядность: ключевой шаг

Главная причина неудач при регистрации COM-объектов для 1С — несовпадение разрядности. Правило простое: разрядность DLL должна совпадать с разрядностью того процесса, который будет её загружать. Если COM-объект создаётся на клиенте — ориентируйтесь на разрядность клиентского приложения 1С; если на сервере 1С — на разрядность сервера (rphost), который в современных установках обычно 64-разрядный.

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

Узнать разрядность самой DLL можно через средства разработки (например, dumpbin /headers) или по документации поставщика. Если документации нет, а объект должен работать на сервере 1С, почти всегда требуется 64-разрядная версия библиотеки.

Регистрация через regsvr32: пошаговый порядок

Стандартная регистрация выполняется из командной строки, запущенной с повышенными привилегиями. Порядок одинаков для собственных библиотек, сторонних компонентов и COM-коннектора 1С.

1. 1
   Скопируйте DLL в постоянный каталог, например C:\Components\MyComponent.dll
2. 2
   Откройте командную строку от имени администратора (Пуск → cmd → «Запуск от имени администратора»)
3. 3
   Для 64-разрядной DLL выполните: regsvr32 "C:\Components\MyComponent.dll"
4. 4
   Для 32-разрядной DLL на 64-разрядной Windows выполните: C:\Windows\SysWOW64\regsvr32 "C:\Components\MyComponent.dll"
5. 5
   Дождитесь диалога «DllRegisterServer ... выполнено успешно»
6. 6
   Проверьте создание объекта в 1С: Объект = Новый COMОбъект("MyComponent.ProgID")

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

Для снятия регистрации используется ключ /u: regsvr32 /u "путь\к\библиотеке.dll". Это необходимо перед удалением файла или при переустановке компонента в другой каталог — иначе в реестре останутся «мертвые» записи.

C:\Windows\SysWOW64\regsvr32 "C:\Program Files\1cv8\8.3.22.1750\bin\comcntr.dll"

Регистрация COM-коннектора 1С (V83.COMConnector)

Отдельный частый сценарий — регистрация COM-соединителя, через который внешние приложения и другие базы 1С подключаются к информационной базе. За него отвечает библиотека comcntr.dll, расположенная в каталоге bin конкретной версии платформы.

Команда регистрации: regsvr32 "C:\Program Files\1cv8\<версия>\bin\comcntr.dll". Важный нюанс: при обновлении платформы путь меняется, так как номер версии входит в имя каталога. Если после обновления 1С внешнее подключение перестало работать с ошибкой «Класс не зарегистрирован», почти всегда нужно заново зарегистрировать comcntr.dll из каталога новой версии.

После регистрации подключение из кода выглядит так: создаётся объект Новый COMОбъект("V83.COMConnector"), затем вызывается метод Connect со строкой соединения. Если база серверная, в строке указываются Srvr и Ref; если файловая — File с путём к каталогу базы.

Регистрация внешних компонентов по технологии Native API

Внешние компоненты 1С (сканеры штрихкодов, торговое оборудование, криптография) бывают двух типов: классические COM и компоненты по технологии Native API. Первые регистрируются через regsvr32, как описано выше. Вторые регистрации в Windows не требуют вовсе — они подключаются в 1С методом ПодключитьВнешнююКомпоненту из макета конфигурации или напрямую из файла.

Если компонент поставляется в виде ZIP-архива с манифестом (manifest.xml) и набором DLL под разные платформы — это Native API, и попытка зарегистрировать его через regsvr32 бессмысленна: библиотека не экспортирует DllRegisterServer. Признак такой ситуации — ошибка «точка входа DllRegisterServer не найдена».

Для Native API-компонентов на сервере достаточно поместить файлы в доступный серверу 1С каталог и подключить компоненту программно. Разрядность при этом выбирается автоматически по манифесту, если в архив включены обе версии.

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

Минимальная проверка — создание объекта из кода 1С в тонком или толстом клиенте: Объект = Новый COMОбъект("ProgID.Компоненты"). Если объект создан без исключения, регистрация выполнена корректно для данного процесса. Для проверки без 1С подойдёт PowerShell: New-Object -ComObject "ProgID".

Ошибка «Класс не зарегистрирован» (0x80040154) означает, что в реестре нет записи для указанного ProgID в нужной разрядности. Проверьте: зарегистрирована ли библиотека той версией regsvr32, которая соответствует разрядности процесса 1С; не изменился ли путь к файлу; тот ли ProgID указан в коде.

Ошибка «Отказано в доступе» при создании объекта на сервере обычно связана с правами учётной записи, под которой работает агент сервера 1С (по умолчанию USR1CV8). Этой учётной записи нужны права на чтение и выполнение файла DLL, а в отдельных случаях — настройка DCOM-разрешений через компонент dcomcnfg.

Ограничения и альтернативы

COM-технология работает только под Windows. Если сервер 1С развёрнут на Linux, COM-объекты на нём недоступны в принципе — для интеграций используются Native API-компоненты, веб-сервисы или HTTP-интерфейсы. Это важно учитывать при проектировании обменов: код с Новый COMОбъект на Linux-сервере завершится ошибкой.

Второе ограничение — безопасность и сопровождение. Каждый зарегистрированный COM-объект — это зависимость от конкретного файла по конкретному пути и от разрядности процесса. В долгосрочной перспективе для обмена между базами 1С надёжнее HTTP-сервисы и EnterpriseData, а для оборудования — компоненты Native API из актуальных библиотек подключаемого оборудования.

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