Apparaatupdate voor IoT Hub-foutcodes
Dit document bevat een tabel met foutcodes voor verschillende onderdelen van Device Update.
Er zijn twee primaire onderdelen aan de clientzijde die foutcodes kunnen genereren: de Device Update-agent en de Delivery Optimization-agent. Foutcodes zijn ook afkomstig van de Device Update-inhoudsservice.
Device Update-agent
ResultCode en ExtendedResultCode
De apparaatupdate voor IoT Hub Core PnP-interfacerapporten ResultCode en ExtendedResultCode, die kunnen worden gebruikt om fouten te diagnosticeren. Zie Device Update en Plug en Play voor meer informatie over de PnP-interface van Device Update Core. Zie de GitHub-opslagplaats device update voor meer informatie over de standaard betekenissen van Device Update-agent ResultCode en ExtendedResultCodes.
ResultCode is een algemene statuscode en ExtendedResultCode is een geheel getal met gecodeerde foutgegevens.
Het ExtendedResultCode wordt weergegeven als een ondertekend geheel getal in de PnP-interface. Als u het ExtendedResultCodeteken wilt decoderen, converteert u het ondertekende gehele getal naar niet-ondertekende hex. Alleen de eerste 4 bytes van de code ExtendedResultCode worden gebruikt en zijn van de vorm F FFFFFFF waarin de eerste nibble de Facility Code is en de rest van de bits de foutcode.
Faciliteitcodes
| Faciliteitcode | Beschrijving |
|---|---|
| D | Fout die is opgetreden bij de DO SDK |
| E | Foutcode is een errno |
Voorbeeld:
ExtendedResultCode is -536870781
De niet-ondertekende hexweergave is -536870781 FFFFFFFF E0000083.
| Negeren | Faciliteitcode | Foutcode |
|---|---|---|
| FFFFFFFF | E | 0000083 |
0x83 in hex is 131 decimaal, wat de errno-waarde is voor ENOLCK.
Delivery Optimization-agent
De volgende tabel bevat foutcodes met betrekking tot het onderdeel Delivery Optimization (DO) van de Device Update-client. Het DO-onderdeel is verantwoordelijk voor het downloaden van update-inhoud op het IoT-apparaat.
De DO-foutcode kan worden verkregen door de uitzonderingen te onderzoeken die zijn gegenereerd als reactie op een API-aanroep. Alle DO-foutcodes kunnen worden geïdentificeerd door het 0x80D0 voorvoegsel.
| Foutcode | Tekenreeksfout | Type | Description |
|---|---|---|---|
| 0x80D01001L | DO_E_NO_SERVICE | n.v.t. | Delivery Optimization kan de service niet leveren |
| 0x80D02002L | DO_E_DOWNLOAD_NO_PROGRESS | Taak downloaden | Downloaden van een bestand heeft geen voortgang gezien binnen de gedefinieerde periode |
| 0x80D02011L | DO_E_UNKNOWN_PROPERTY_ID | Taak downloaden | SetProperty() of GetProperty() aangeroepen met een onbekende eigenschaps-id |
| 0x80D02012L | DO_E_READ_ONLY_PROPERTY | Taak downloaden | Kan SetProperty() niet aanroepen voor een alleen-lezen eigenschap |
| 0x80D02013L | DO_E_INVALID_STATE | Taak downloaden | De aangevraagde actie is niet toegestaan in de huidige taakstatus. De taak is mogelijk geannuleerd of voltooid. Het heeft nu de status Alleen-lezen. |
| 0x80D02018L | DO_E_FILE_DOWNLOADSINK_UNSPECIFIED | Taak downloaden | Kan een download niet starten omdat er geen downloadsink (lokaal bestand of streaminterface) is opgegeven |
| 0x80D02200L | DO_E_DOWNLOAD_NO_URI | IDODownload Interface | Het downloaden is gestart zonder een URI op te geven |
| 0x80D03805L | DO_E_BLOCKED_BY_NO_NETWORK | Tijdelijke omstandigheden | Downloaden onderbroken vanwege verlies van netwerkverbinding |
0 00 00000 Total 4 bytes (32 bits)
- -- -----
| | |
| | |
| | +--------- Error code (20 bits)
| |
| +------------- Component/Area code (8 bits)
|
+--------------- Facility code (4 bits)
Zie Resultaatcodes van Device Update Agent en uitgebreide resultaatcodes of implementeer een aangepaste inhoudshandler voor meer informatie over het parseren van codes.
Device Update-inhoudsservice
De volgende tabel bevat foutcodes met betrekking tot het inhoudsserviceonderdeel van de Device Update-service. Het inhoudsserviceonderdeel is verantwoordelijk voor het importeren van update-inhoud. Meer informatie over het oplossen van problemen is ook beschikbaar voor het importeren van proxy-updates.
| Foutcode | Tekenreeksfout | Volgende stappen |
|---|---|---|
| UpdateAlreadyExists | Er bestaat al een update met dezelfde identiteit. | Zorg ervoor dat u een update importeert die nog niet is geïmporteerd in dit exemplaar van Device Update voor IoT Hub. |
| DuplicateContentImport | Identieke inhoud die meerdere keren tegelijk wordt geïmporteerd. | Zorg ervoor dat u een update importeert die nog niet is geïmporteerd in dit exemplaar van Device Update voor IoT Hub. |
| CannotProcessImportManifest | Fout bij het verwerken van het importmanifest. | Raadpleeg de importconcepten en de documentatie voor het importeren van updates voor de juiste opmaak van het importmanifest. |
| CannotDownload | Kan het importmanifest niet downloaden. | Controleer of de URL voor het importmanifestbestand nog steeds geldig is. |
| Kan niet parseren | Kan het importmanifest niet parseren. | Controleer uw importmanifest op nauwkeurigheid op basis van het schema dat is gedefinieerd in de documentatie voor het importeren van updates . |
| Niet-ondersteunde Versie | De schemaversie van het manifest importeren wordt niet ondersteund. | Zorg ervoor dat uw importmanifest gebruikmaakt van het meest recente schema dat is gedefinieerd in de documentatie voor het importeren van updates . |
| Fout bij het importeren van update vanwege een overschreden limiet. | Kan geen extra updateprovider importeren. | U hebt een limiet bereikt voor het aantal verschillende providers dat is toegestaan in uw exemplaar van Device Update voor IoT Hub. Verwijder enkele updates uit uw exemplaar en probeer het opnieuw. |
| Fout bij het importeren van update vanwege een overschreden limiet. | Kan geen extra updatenaam importeren voor de opgegeven provider. | U hebt een limiet bereikt voor het aantal verschillende namen dat is toegestaan onder één provider in uw exemplaar van Device Update voor IoT Hub. Verwijder enkele updates uit uw exemplaar en probeer het opnieuw. |
| Fout bij het importeren van update vanwege een overschreden limiet. | Kan geen extra updateversie importeren voor de opgegeven provider en naam. | U hebt een limiet bereikt voor het aantal verschillende versies dat is toegestaan onder één provider en de naam in uw exemplaar van Device Update voor IoT Hub. Verwijder enkele updates met die naam uit uw exemplaar en probeer het opnieuw. |
| Fout bij het importeren van update vanwege een overschreden limiet. | Kan geen extra updateprovider importeren met de opgegeven compatibiliteit. or Kan geen extra updatenaam importeren met de opgegeven compatibiliteit. or Kan geen extra updateversie importeren met de opgegeven compatibiliteit. |
Houd er bij het definiëren van compatibiliteitseigenschappen in een importmanifest rekening mee dat Device Update voor IoT Hub ondersteuning biedt voor één provider en naamcombinatie voor een bepaalde set compatibiliteitseigenschappen. Als u dezelfde compatibiliteitseigenschappen probeert te gebruiken met meer dan één combinatie van provider/naam, ziet u deze fouten. U kunt dit probleem oplossen door ervoor te zorgen dat alle updates voor een bepaald apparaat (zoals gedefinieerd door compatibiliteitseigenschappen) dezelfde provider en naam gebruiken. |
| CannotProcessUpdateFile | Fout bij het verwerken van bronbestand. | |
| ContentFileCannotDownload | Kan het bronbestand niet downloaden. | Controleer of de URL voor de updatebestanden nog geldig is. |
| SourceFileMalwareDetected | Er is een bekende malwarehandtekening gedetecteerd in een bestand dat wordt geïmporteerd. | Device Update voor IoT Hub scant geïmporteerde inhoud op malware met behulp van verschillende mechanismen. Als er een bekende malwarehandtekening wordt geïdentificeerd, mislukt het importeren en wordt er een uniek foutbericht geretourneerd. Het foutbericht bevat de beschrijving van de malwarehandtekening en een bestands-hash voor elk bestand waarin de handtekening is gedetecteerd. U kunt de bestands-hash gebruiken om het exacte bestand te vinden dat wordt gemarkeerd en gebruik de beschrijving van de malwarehandtekening om dat bestand te controleren op malware. Nadat u de malware hebt verwijderd uit bestanden die worden geïmporteerd, kunt u het importproces opnieuw starten. |
| SourceFilePendingMalwareAnalysis | Er is een handtekening gedetecteerd in een bestand dat wordt geïmporteerd die kan aangeven dat er malware aanwezig is. | Device Update voor IoT Hub scant geïmporteerde inhoud op malware met behulp van verschillende mechanismen. Het importeren mislukt als een scanhandtekening kenmerken heeft van malware, zelfs als er geen exacte overeenkomst is met bekende malware. Wanneer dit gebeurt, wordt er een uniek foutbericht geretourneerd. Het foutbericht bevat de beschrijving van de verdachte malwarehandtekening en een bestands-hash voor elk bestand waar de handtekening is gedetecteerd. U kunt de bestands-hash gebruiken om het exacte bestand te vinden dat wordt gemarkeerd en gebruik de beschrijving van de malwarehandtekening om dat bestand te controleren op malware. Nadat u de malware hebt verwijderd uit bestanden die worden geïmporteerd, kunt u het importproces opnieuw starten. Als u zeker weet dat uw bestanden geen malware bevatten en deze fout blijven zien, gebruikt u het proces contact Microsoft Ondersteuning. |