Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Dieses Dokument enthält eine Tabelle mit Fehlercodes für verschiedene Device Update-Komponenten. Es soll als Referenz für Benutzer verwendet werden, die ihre eigenen Fehlercodes analysieren möchten, um Probleme zu diagnostizieren und zu beheben.
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.
ResultCode ist ein allgemeiner Statuscode und ExtendedResultCode eine ganze Zahl mit codierten Fehlerinformationen.
Wahrscheinlich wird die ExtendedResultCode als signierte ganze Zahl 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 FFFFFFFF 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 -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 | Typ | BESCHREIBUNG |
|---|---|---|---|
| 0x80D01001L | DO_E_NO_SERVICE | n/a | 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 Auftragsstatus nicht zulässig. Möglicherweise wurde der Auftrag abgebrochen oder die Übertragung 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. | Inhalte, die in Device Update für IoT Hub importiert wurden, werden durch verschiedene Mechanismen auf Schadsoftware gescannt. 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. | Inhalte, die in Device Update für IoT Hub importiert wurden, werden durch verschiedene Mechanismen auf Schadsoftware gescannt. Der Import schlägt fehl, wenn eine Überprüfungssignatur Merkmale von Schadsoftware aufweist, auch wenn keine genaue Übereinstimmung mit bekannten Schadsoftware vorhanden ist. 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. |