Fehlercodes für Device Update for IoT Hub

Artikel
03/27/2023

Dieses Dokument enthält eine Tabelle mit Fehlercodes für verschiedene Device Update-Komponenten.

Es gibt zwei primäre clientseitige Komponenten, die möglicherweise Fehlercodes auslösen: den Device Update-Agent und den Übermittlungsoptimierungs-Agent. Fehlercodes stammen auch vom Device Update-Inhaltsdienst.

Device Update-Agent

ResultCode und ExtendedResultCode

Die PNP-Schnittstelle von Device Update for IoT Hub Core meldet ResultCode und ExtendedResultCode, die zur Diagnose von Fehlern verwendet werden können. Weitere Informationen zur PNP-Schnittstelle von Device Update for IoT Hub Core finden Sie unter Device Update for IoT Hub und IoT Plug & Play. Weitere Informationen zu den Standardbedeutungen der Device Update-Agents „ResultCode“ und „ExtendedResultCodes“ finden Sie unter Device Update GitHub-Repository.

ResultCode ist ein allgemeiner Statuscode und ExtendedResultCode eine ganze Zahl mit codierten Fehlerinformationen.

ExtendedResultCode wird als ganze Zahl mit Vorzeichen in der PNP-Schnittstelle angezeigt. Konvertieren Sie die ganze Zahl mit Vorzeichen in ein Hexadezimalformat ohne Vorzeichen, um ExtendedResultCode zu decodieren. Nur die ersten 4 Bytes von ExtendedResultCode werden verwendet und weisen das Format F FFFFFFF auf, wobei der erste Teil den Einrichtungscode und die restlichen Bits den Fehlercode darstellen.

Einrichtungscodes

Einrichtungscode	BESCHREIBUNG
D	Vom DO SDK ausgelöster Fehler
E	Fehlercode: errno

Beispiel:

ExtendedResultCode ist gleich -536870781.

Die Hexadezimaldarstellung ohne Vorzeichen von -536870781 ist FFFFFFFF E0000083.

Ignorieren	Einrichtungscode	Fehlercode
FFFFFFFF	E	0000083

0x83 in Hexadezimaldarstellung ist 131 in Dezimaldarstellung: errno-Wert für ENOLCK.

Übermittlungsoptimierungs-Agent

In der folgenden Tabelle sind die Fehlercodes aufgeführt, die sich auf die Komponente zur Übermittlungsoptimierung (DO) des Device Update-Clients beziehen. Die DO-Komponente ist für das Herunterladen von Updateinhalten auf das IoT-Gerät verantwortlich.

Der DO-Fehlercode kann durch Untersuchen der Ausnahmen abgerufen werden, die als Reaktion auf einen API-Befehl ausgelöst werden. Alle Fehlercodes können durch das Präfix 0x80D0 identifiziert werden.

Fehlercode	Zeichenfolgenfehler	type	BESCHREIBUNG
0x80D01001L	DO_E_NO_SERVICE	–	Die Übermittlungsoptimierung konnte den Dienst nicht bereitstellen.
0x80D02002L	DO_E_DOWNLOAD_NO_PROGRESS	Auftrag herunterladen	Beim Herunterladen einer Datei ist innerhalb des definierten Zeitraums kein Fortschritt aufgetreten.
0x80D02011L	DO_E_UNKNOWN_PROPERTY_ID	Auftrag herunterladen	SetProperty() oder GetProperty() wurde mit einer unbekannten Eigenschaften-ID aufgerufen.
0x80D02012L	DO_E_READ_ONLY_PROPERTY	Auftrag herunterladen	SetProperty() kann nicht für eine schreibgeschützte Eigenschaft aufgerufen werden.
0x80D02013L	DO_E_INVALID_STATE	Auftrag herunterladen	Die angeforderte Aktion ist im aktuellen Auftragszustand nicht zulässig. Der Auftrag wurde möglicherweise abgebrochen, oder die Übertragung wurde abgeschlossen. Er befindet sich jetzt in einem schreibgeschützten Zustand.
0x80D02018L	DO_E_FILE_DOWNLOADSINK_UNSPECIFIED	Auftrag herunterladen	Ein Download kann nicht gestartet werden, da keine Downloadsenke (lokale Datei oder Streamschnittstelle) angegeben wurde.
0x80D02200L	DO_E_DOWNLOAD_NO_URI	IDODownload-Schnittstelle	Der Download wurde ohne Angabe eines URI gestartet.
0x80D03805L	DO_E_BLOCKED_BY_NO_NETWORK	Vorübergehende Schwierigkeiten	Der Download wurde aufgrund des Verlusts der Netzwerkkonnektivität angehalten.

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

Weitere Informationen zum Analysieren von Codes finden Sie unter Ergebniscodes und erweiterte Ergebniscodes des Device Update-Agents und Implementieren eines benutzerdefinierten Inhaltshandlers.

Device Update-Inhaltsdienst

In der folgenden Tabelle werden Fehlercodes aufgeführt, die sich auf die Inhaltsdienstkomponente des Device Update-Diensts beziehen. Die Inhaltsdienstkomponente ist für das Importieren von Update-Inhalten zuständig. Weitere Informationen zur Problembehandlung sind auch für den Import von Proxyupdates verfügbar.

Fehlercode	Zeichenfolgenfehler	Nächste Schritte
UpdateAlreadyExists	Ein Update mit der gleichen Identität ist bereits vorhanden.	Stellen Sie sicher, dass Sie ein Update importieren, das nicht bereits in diese Instanz von Device Update for IoT Hub importiert wurde.
DuplicateContentImport	Identischer Inhalt wurde gleichzeitig mehrmals importiert.	Stellen Sie sicher, dass Sie ein Update importieren, das nicht bereits in diese Instanz von Device Update for IoT Hub importiert wurde.
CannotProcessImportManifest	Fehler beim Verarbeiten des Importmanifests.	Informationen zur ordnungsgemäßen Formatierung des Importmanifests finden Sie unter Importkonzepte und in der Dokumentation zum Importieren des Updates.
CannotDownload	Das Importmanifest kann nicht heruntergeladen werden.	Stellen Sie sicher, dass die URL für die Importmanifestdatei noch gültig ist.
CannotParse	Das Importmanifest kann nicht analysiert werden.	Überprüfen Sie das Importmanifest anhand des Schemas auf Genauigkeit, das in der Dokumentation zum Importieren des Updates definiert ist.
UnsupportedVersion	Die Schemaversion des Importmanifests wird nicht unterstützt.	Stellen Sie sicher, dass das Importmanifest das neueste Schema verwendet, das in der Dokumentation zum Importieren des Updates definiert ist.
Fehler beim Importieren des Updates aufgrund eines überschrittenen Grenzwerts.	Es kann kein zusätzlicher Updateanbieter importiert werden.	Sie haben einen Grenzwert für die Anzahl der unterschiedlichen Anbieter erreicht, die in Ihrer Instanz von Device Update for IoT Hub zulässig sind. Löschen Sie einige Updates aus der Instanz, und versuchen Sie es noch mal.
Fehler beim Importieren des Updates aufgrund eines überschrittenen Grenzwerts.	Für den angegebenen Anbieter kann kein zusätzlicher Updatename importiert werden.	Sie haben einen Grenzwert für die Anzahl der unterschiedlichen Namen erreicht, die unter einem Anbieter in Ihrer Instanz von Device Update for IoT Hub zulässig sind. Löschen Sie einige Updates aus der Instanz, und versuchen Sie es noch mal.
Fehler beim Importieren des Updates aufgrund eines überschrittenen Grenzwerts.	Für den angegebenen Anbieter und Namen kann keine zusätzliche Updateversion importiert werden.	Sie haben einen Grenzwert für die Anzahl der unterschiedlichen Versionen erreicht, die unter einem Anbieter und Namen in Ihrer Instanz von Device Update for IoT Hub zulässig sind. Löschen Sie einige Updates mit diesem Namen aus Ihrer Instanz, und versuchen Sie es noch mal.
Fehler beim Importieren des Updates aufgrund eines überschrittenen Grenzwerts.	Ein zusätzlicher Updateanbieter mit der angegebenen Kompatibilität kann nicht importiert werden. or Ein zusätzlicher Updatename mit der angegebenen Kompatibilität kann nicht importiert werden. or Eine zusätzliche Updateversion mit der angegebenen Kompatibilität kann nicht importiert werden.	Beachten Sie beim Definieren von Kompatibilitätseigenschaften in einem Importmanifest, dass Device Update for IoT Hub eine einzige Kombination aus Anbieter und Name für einen bestimmten Satz an Kompatibilitätseigenschaften unterstützt. Wenn Sie versuchen, die gleichen Kompatibilitätseigenschaften mit mehr als einer Kombination aus Anbieter und Name zu verwenden, werden diese Fehler angezeigt. Um dieses Problem zu beheben, stellen Sie sicher, dass alle Updates für ein bestimmtes Gerät (wie durch Kompatibilitätseigenschaften definiert) denselben Anbieter und Namen verwenden.
CannotProcessUpdateFile	Fehler beim Verarbeiten der Quelldatei.
ContentFileCannotDownload	Die Quelldatei kann nicht heruntergeladen werden.	Stellen Sie sicher, dass die URL für die Updatedatei(en) noch gültig ist.
SourceFileMalwareDetected	In einer zu importierenden Datei wurde eine bekannte Schadsoftwaresignatur erkannt.	Device Update for IoT Hub überprüft importierte Inhalte auf Schadsoftware mithilfe verschiedener Mechanismen. Wenn eine bekannte Schadsoftwaresignatur erkannt wird, führt der Import zu Fehlern, und eine eindeutige Fehlermeldung wird zurückgegeben. Die Fehlermeldung enthält die Beschreibung der Schadsoftwaresignatur und einen Dateihash für jede Datei, in der die Signatur erkannt wurde. Sie können den Dateihash verwenden, um die markierte Datei zu finden, und die Beschreibung der Schadsoftwaresignatur, um diese Datei auf Schadsoftware zu überprüfen. Nachdem Sie die Schadsoftware aus allen importierten Dateien entfernt haben, können Sie den Importvorgang erneut starten.
SourceFilePendingMalwareAnalysis	In einer importierten Datei wurde eine Signatur erkannt, die möglicherweise auf vorhandene Schadsoftware hindeutet.	Device Update for IoT Hub überprüft importierte Inhalte auf Schadsoftware mithilfe verschiedener Mechanismen. Der Import schlägt fehl, wenn eine Überprüfungssignatur Merkmale von Schadsoftware aufweist, selbst wenn es keine genaue Übereinstimmung mit bekannter Schadsoftware gibt. In diesem Fall wird eine eindeutige Fehlermeldung zurückgegeben. Die Fehlermeldung enthält die Beschreibung der mutmaßlichen Schadsoftwaresignatur und einen Dateihash für jede Datei, in der die Signatur erkannt wurde. Sie können den Dateihash verwenden, um die markierte Datei zu finden, und die Beschreibung der Schadsoftwaresignatur, um diese Datei auf Schadsoftware zu überprüfen. Nachdem Sie die Schadsoftware aus allen importierten Dateien entfernt haben, können Sie den Importvorgang erneut starten. Wenn Sie sicher sind, dass Ihre Dateien frei von Schadsoftware sind, und dieser Fehler weiterhin angezeigt wird, kontaktieren Sie den Microsoft-Support.

Nächste Schritte

Beheben von Problemen mit Device Update

Freigeben über