Коды ошибок службы "Обновление устройств для Центра Интернета вещей"

Статья
03/21/2023

В этом документе содержится таблица кодов ошибок для различных компонентов Обновления устройств.

Существует два основных клиентских компонента, которые могут выдавать коды ошибок: агент Обновления устройств и агент Оптимизации доставки. Коды ошибок также поступают из службы содержимого Обновления устройств.

Агент Обновления устройств

ResultCode и ExtendedResultCode

Интерфейс Plug and Play Обновления устройств для Центра Интернета вещей (Базовый) выдает сообщения ResultCode и ExtendedResultCode, которые можно использовать для диагностики сбоев. Дополнительные сведения об интерфейсе Plug and Play Обновления устройств для Центра Интернета вещей (Базовый) см. в статье Обновление устройств и Plug and Play. Дополнительные сведения о значениях агента обновления устройств по умолчанию— ResultCode и ExtendedResultCodes см. в репозитории GitHub для обновления устройств.

ResultCode — это общий код состояния, а ExtendedResultCode — это целочисленное значение, содержащее закодированные сведения об ошибке.

Он ExtendedResultCode отображается как целое число со знаком в интерфейсе PnP. Чтобы декодировать ExtendedResultCode, преобразуйте целочисленное значение со знаком в шестнадцатеричное значение без знака. В ExtendedResultCode используются только первые 4 байта в виде FFFFFFFF, где первая часть представляет собой код устройства, а остальные биты — код ошибки.

Коды устройств

Код устройства	Description
D	Ошибка из пакета SDK оптимизации доставки
E	Код ошибки типа errno

Например:

ExtendedResultCode имеет значение -536870781.

-536870781 в шестнадцатеричном представлении без знака равно FFFFFFFF E0000083.

Пропустить	Код устройства	Код ошибки
FFFFFFFF	E	0000083

0x83 в шестнадцатеричном представлении соответствует 131 в десятичном представлении, которое является значением errno для ENOLCK.

Агент оптимизации доставки

В таблице ниже перечислены коды ошибок, относящиеся к компоненту оптимизации доставки клиента Обновления устройств. Компонент оптимизации доставки отвечает за загрузку обновления содержимого на устройство IoT.

Код ошибки можно получить, изучив исключения, выданные в ответ на вызов API. Все коды ошибок оптимизации доставки можно идентифицировать по префиксу 0x80D0.

Код ошибки	Строковая ошибка	Тип	Описание
0x80D01001L	DO_E_NO_SERVICE	Н/Д	Службе оптимизации доставки не удалось предоставить службу
0x80D02002L	DO_E_DOWNLOAD_NO_PROGRESS	Задание загрузки	Загрузка файла не продолжается в течение указанного периода времени
0x80D02011L	DO_E_UNKNOWN_PROPERTY_ID	Задание загрузки	Свойство SetProperty() или GetProperty() вызвано с неизвестным идентификатором свойства
0x80D02012L	DO_E_READ_ONLY_PROPERTY	Задание загрузки	Не удается вызвать свойство SetProperty() для свойства, доступного только для чтения
0x80D02013L	DO_E_INVALID_STATE	Задание загрузки	Запрошенное действие не допускается в текущем состоянии задания. Возможно, задание было отменено или завершено. Сейчас оно находится в состоянии "только для чтения".
0x80D02018L	DO_E_FILE_DOWNLOADSINK_UNSPECIFIED	Задание загрузки	Не удалось начать загрузку, так как не указан приемник загрузки (локальный файл или потоковый интерфейс)
0x80D02200L	DO_E_DOWNLOAD_NO_URI	Интерфейс IDODownload	Загрузка началась без указания URI
0x80D03805L	DO_E_BLOCKED_BY_NO_NETWORK	Временные условия	Загрузка приостановлена из-за потери сетевого подключения

   0 00 00000     Total 4 bytes (32 bits)
   - -- -----
   | |  |
   | |  |
   | |  +---------  Error code (20 bits)
   | |
   | +------------- Component/Area code (8 bits)
   |
   +--------------- Facility code (4 bits)

Дополнительные сведения о кодах анализа см. в разделе Коды результатов агента Обновления устройств и расширенные коды результатов или реализуйте пользовательский обработчик содержимого.

Служба содержимого Обновления устройств

В таблице ниже перечислены коды ошибок, относящиеся к компоненту службы содержимого службы "Обновление устройств". Компонент службы содержимого отвечает за импорт содержимого обновления. Дополнительные сведения об устранении неполадок также доступны для импорта обновлений прокси-сервера.

Код ошибки	Строковая ошибка	Следующие шаги
UpdateAlreadyExists	Обновление с таким удостоверением уже существует.	Убедитесь, что вы импортируете обновление, которое еще не было импортировано в этот экземпляр Обновления устройств для Центра Интернета вещей.
DuplicateContentImport	Идентичное содержимое импортировано несколько раз одновременно.	Убедитесь, что вы импортируете обновление, которое еще не было импортировано в этот экземпляр Обновления устройств для Центра Интернета вещей.
CannotProcessImportManifest	Ошибка при обработке манифеста импорта.	Сведения о правильном форматировании манифеста импорта см. в документации по import concepts и import update.
CannotDownload	Не удается скачать манифест импорта.	Убедитесь, что URL-адрес файла манифеста импорта все еще действителен.
CannotParse	Не удается проанализировать манифест импорта.	Проверьте правильность манифеста импорта в соответствии со схемой, определенной в документации по import update.
UnsupportedVersion	Версия схемы манифеста импорта не поддерживается.	Убедитесь, что в манифесте импорта используется последняя схема, определенная в документации по import update.
Ошибка при импорте обновления из-за превышения предела.	Невозможно импортировать поставщик дополнительного обновления.	Достигнуто предельное число различных поставщиков, разрешенных в вашем экземпляре Обновления устройств для Центра Интернета вещей. Удалите некоторые обновления из экземпляра и повторите попытку.
Ошибка при импорте обновления из-за превышения предела.	Невозможно импортировать имя дополнительного обновления для указанного поставщика.	Достигнуто предельное число различных имен, разрешенных для одного поставщика в вашем экземпляре Обновления устройств для Центра Интернета вещей. Удалите некоторые обновления из экземпляра и повторите попытку.
Ошибка при импорте обновления из-за превышения предела.	Невозможно импортировать версию дополнительного обновления для указанного поставщика и имени.	Достигнуто предельное число различных версий, разрешенных для одного поставщика и имени в вашем экземпляре Обновления устройств для Центра Интернета вещей. Удалите некоторые обновления с этим именем из экземпляра и повторите попытку.
Ошибка при импорте обновления из-за превышения предела.	Не удается импортировать поставщик дополнительного обновления с указанной совместимостью. or Не удается импортировать имя дополнительного обновления с указанной совместимостью. or Не удается импортировать версию дополнительного обновления с указанной совместимостью.	Определяя свойства совместимости в манифесте импорта, следует помнить, что Обновление устройств для Центра Интернета вещей поддерживает одно сочетание поставщика и имени для определенного набора свойств совместимости. При попытке использовать одни и те же свойства совместимости с несколькими сочетаниями "поставщик — имя" будут отображаться эти ошибки. Чтобы устранить эту проблему, убедитесь, что все обновления для определенного устройства (как определено свойствами совместимости) используют тот же поставщик и то же имя.
CannotProcessUpdateFile	Ошибка при обработке исходного файла.
ContentFileCannotDownload	Не удается скачать исходный файл.	Убедитесь, что URL-адрес файлов обновления все еще действителен.
SourceFileMalwareDetected	В импортируемом файле обнаружена известная сигнатура вредоносной программы.	Обновление устройства для Центр Интернета вещей проверяет импортированное содержимое для вредоносных программ с помощью нескольких различных механизмов. Если определена известная сигнатура вредоносной программы, импорт завершается сбоем и возвращается уникальное сообщение об ошибке. Сообщение об ошибке содержит описание сигнатуры вредоносной программы и хэш для каждого файла, где была обнаружена эта сигнатура. Вы можете использовать такой хэш файла, чтобы найти конкретный файл, который вызвал проблему, и использовать описание сигнатуры вредоносной программы, чтобы проверить этот файл на наличие вредоносных программ. После удаления вредоносных программ из импортируемых файлов можно снова запустить процесс импорта.
SourceFilePendingMalwareAnalysis	В импортируемом файле обнаружена сигнатура, которая может означать наличие вредоносных программ.	Обновление устройства для Центр Интернета вещей проверяет импортированное содержимое для вредоносных программ с помощью нескольких различных механизмов. Импорт завершается ошибкой, если сигнатура сканирования имеет характеристики вредоносных программ, даже если нет точного совпадения с известными вредоносными программами. В этом случае возвращается уникальное сообщение об ошибке. Сообщение об ошибке содержит описание сигнатуры подозреваемой вредоносной программы и хэш для каждого файла, где была обнаружена эта сигнатура. Вы можете использовать такой хэш файла, чтобы найти конкретный файл, который вызвал проблему, и использовать описание сигнатуры вредоносной программы, чтобы проверить этот файл на наличие вредоносных программ. После удаления вредоносных программ из импортируемых файлов можно снова запустить процесс импорта. Если вы уверены, что ваши файлы не содержат вредоносные программы и продолжаете сталкиваться с этой ошибкой, используйте процедуру обращения в службу поддержки Майкрософт.

Следующие шаги

Устранение неполадок в Обновлении устройств

Поделиться через