← На главную

При формировании печатных форм с печатью штрихкодов или QR-кодов пользователи и разработчики часто сталкиваются со сбоем инициализации внешней компоненты. В системном журнале и на экране появляется сообщение об ошибке: -2147221005 (0x800401F3): Недопустимая строка с указанием класса. Компонента 1С:Печать штрихкодов не установлена на данном компьютере!

Рассмотрим подробно причины возникновения этой проблемы и разберем практические варианты её решения в различных сценариях работы с платформой 1С:Предприятие 8.3.

Причины возникновения ошибки 0x800401F3

Ошибка с кодом 0x800401F3 в ОС Windows означает, что вызываемый класс COM/ActiveX не зарегистрирован в системном реестре или приложение не может его найти. Выясним главные причины, по которым платформа 1С не может проинициализировать компоненту:

1. Несоответствие разрядности (32 bit / 64 bit): Классическая внешняя компонента 1CBarCode поставляется в виде 32-битной ActiveX-библиотеки (DLL). Если на рабочем месте или на сервере используется 64-разрядный клиент 1С:Предприятия (x64), он физически не может напрямую загрузить 32-битный COM-объект в свой адресный процесс.
2. Отсутствие регистрации библиотеки в реестре: Библиотека компоненты может быть скопирована на диск, но процедура регистрации в Windows не была выполнена (например, инсталлятор запускался без прав администратора).
3. Исполнение кода на стороне 64-битного сервера: Если генерация печатной формы с вызовом ActiveX происходит на стороне сервера 1С, а серверный процесс имеет разрядность x64, инициализация 32-битного COM-объекта завершится неудачей.
4. Неподдерживаемая среда выполнения: Использование устаревших ActiveX-компонент в веб-клиенте или в клиентских приложениях под управлением Linux/macOS.

Способ 1. Использование 32-битной версии клиента 1С

Проанализируем базовый вариант решения, если печать штрихкодов выполняется на клиентском рабочем месте под управлением Windows. Классический модуль 1CBarCode работает исключительно с 32-разрядными процессами.

Разберем по шагам порядок действий:

1. Удалим или закроем запущенный 64-битный клиент 1С:Предприятия.
2. Установим и запустим 32-разрядную (x86) версию платформы 1С:Предприятие той же версии, которая используется на сервере.
3. Убедимся, что сама компонента печати штрихкодов установлена из дистрибутива. При необходимости выполним ручную регистрацию через командную строку, запущенную от имени администратора: regsvr32 "C:\Program Files (x86)\1C\1CBarCode\1CBarCode.dll"

При использовании 32-битного клиента 1С прекрасно подключается к 64-битному серверу 1С:Предприятия, не создавая конфликтов разрядности процессов при формировании печатных форм.

Способ 2. Переход на современную компоненту NativeAPI

Более надежным и технологичным решением является отказ от устаревшей технологии ActiveX в пользу технологии Native API, применяемой в Библиотеке подключаемого оборудования (БПО).

Рассмотрим ключевые преимущества Native-компонент:

1. Поставляются с одновременной поддержкой 32-битных и 64-битных систем (для клиента и сервера).
2. Не требуют регистрации в реестре Windows через regsvr32 — платформа 1С загружает компоненту напрямую из макета или файла с помощью функции УстановитьВнешнююКомпоненту() и ПодключитьВнешнююКомпоненту().
3. Кроссплатформенность: корректно работают под управлением Windows и Linux.

Способ 3. Включение отладки на сервере 1С

Часто при отладке процедур печати штрихкодов разработчики переключаются между клиентом и сервером. Если после смены разрядности клиента или перенастройки сервера в предметах отладки исчезает контекст Сервер, проанализируем параметры службы 1С:Предприятия.

Для того чтобы включить режим отладки на сервере 1С под управлением Windows, выполним следующие шаги:

1. Остановим службу 1C:Enterprise 8.3 Server Agent в консоли управления службами services.msc.
2. Откроем редактор реестра regedit и перейдем к ветке реестра службы 1С (для 64-битной платформы):
   Скопировать код

   
   HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\1C:Enterprise 8.3 Server Agent (x86-64)
   

3. Найдем параметр ImagePath и добавим ключ -debug в конец строки запуска приложения ragent.exe.
4. Запустим службу 1С:Предприятия повторно.

После этой настройки серверный контекст снова станет доступен в конфигураторе 1С в меню отладки независимо от разрядности используемого клиента.