Как зарегистрировать COM-компоненту 1С

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

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

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

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

Первое — разрядность компоненты и клиента 1С. Если компонента 32-разрядная, она будет работать с 32-разрядным клиентом 1С, но не с 64-разрядным сервером приложений. Для серверного вызова потребуется 64-разрядная версия той же компоненты. Узнать разрядность платформы можно в свойствах ярлыка 1С или в диспетчере задач: у 32-разрядных процессов в старых версиях Windows рядом с именем отображается пометка «(32 бита)».

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

Третье — права. Для регистрации компоненты в системном разделе реестра (HKEY_CLASSES_ROOT) нужны права администратора. Если регистрация выполняется на сервере, согласуйте действия с администратором и заранее сделайте резервную копию важных данных.

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

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

Откройте командную строку от имени администратора: меню «Пуск» → введите cmd → «Запуск от имени администратора». Затем выполните команду, указав полный путь к библиотеке.

regsvr32 "C:\Components\MyComponent.dll"

Для 32-разрядной компоненты на 64-разрядной Windows используйте regsvr32 из папки SysWOW64, иначе библиотека зарегистрируется в 64-разрядном разделе реестра и 32-битный клиент 1С её не увидит.

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

Успех подтверждается диалоговым окном «DllRegisterServer ... успешно выполнена». Ошибка с кодом 0x80070005 означает нехватку прав (запустите консоль от имени администратора), ошибка «модуль загружен, но точка входа не найдена» — что файл не является COM-библиотекой или повреждён.

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

Регистрация из конфигурации 1С

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

Если компонента подключается по ProgID (например, «AddIn.Scanner»), она должна быть зарегистрирована в системе заранее. Тогда используют regsvr32 либо установщик от поставщика, который делает это автоматически.

Пример программного подключения из макета выглядит так:

Если ПодключитьВнешнююКомпоненту("ОбщийМакет.КомпонентаСканера", "Сканер", ТипВнешнейКомпоненты.Native) Тогда
Сообщить("Компонента подключена");
Иначе
Сообщить("Не удалось подключить компоненту");
КонецЕсли;

Как проверить, что компонента зарегистрирована

Самый простой тест — выполнить в 1С создание объекта по ProgID и посмотреть, не возникнет ли исключение. Это можно сделать из внешней обработки или консоли кода:

Попытка
Объект = Новый COMОбъект("AddIn.MyComponent");
Сообщить("Объект создан успешно");
Исключение
Сообщить(ОписаниеОшибки());
КонецПопытки;

Дополнительно можно проверить реестр: откройте редактор реестра (regedit) и найдите ProgID компоненты в разделе HKEY_CLASSES_ROOT. У зарегистрированной компоненты там есть подраздел CLSID, а в HKEY_CLASSES_ROOT\CLSID\{GUID}\InprocServer32 указан путь к DLL. Для 32-разрядной компоненты на 64-разрядной системе запись будет находиться в ветке WOW6432Node.

Типичные ошибки и их причины

Ошибка «Класс не зарегистрирован» (0x80040154) при создании COMОбъекта почти всегда означает одно из трёх: компонента не зарегистрирована вовсе, зарегистрирована не в той разрядности или регистрация выполнена под другим пользователем в разделе HKEY_CURRENT_USER, а 1С запущена под другой учётной записью.

Ошибка «Не удалось загрузить внешнюю компоненту» при работе типовой конфигурации часто связана не с регистрацией, а с тем, что антивирус заблокировал извлечение DLL из макета, либо у пользователя нет прав на временный каталог. Проверьте журнал антивируса и права на папку временных файлов.

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

Как отменить регистрацию

Если компонента больше не нужна или её требуется переустановить, сначала отмените регистрацию той же утилитой с ключом /u, затем удалите файл. Это очищает реестр от записей, которые иначе останутся «мусором» и могут конфликтовать с новой версией.

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

После отмены регистрации перезапустите 1С и убедитесь, что конфигурация не пытается автоматически подключить эту компоненту заново — иначе она может зарегистрироваться снова из макета.

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