Codici di errore di Aggiornamento dispositivi per hub IoT
Questo documento fornisce una tabella di codici di errore per vari componenti di Aggiornamento dispositivi.
Esistono due componenti principali sul lato client che possono generare codici di errore: l'agente di Aggiornamento dispositivi e l'agente di Ottimizzazione recapito. I codici di errore provengono anche dal servizio contenuti di Aggiornamento dispositivi.
Agente di Aggiornamento dispositivi
ResultCode ed ExtendedResultCode
L'interfaccia PnP Core di Aggiornamento dispositivi per hub IoT segnala ResultCode e ExtendedResultCode, che possono essere usati per diagnosticare gli errori. Per altre informazioni sull'interfaccia PnP Core di Aggiornamento dispositivi, vedere Aggiornamento dispositivi e Plug and Play. Per altri dettagli sui significati predefiniti di ResultCode e ExtendedResultCodes dell'agente di Aggiornamento dispositivi, vedere il repository GitHub di Aggiornamento dispositivi.
ResultCode è un codice di stato generale e ExtendedResultCode è un numero intero con informazioni sull'errore codificate.
ExtendedResultCode viene visualizzato come numero intero con segno nell'interfaccia PnP. Per decodificare ExtendedResultCode, convertire il numero intero con segno in valore esadecimale senza segno. Vengono utilizzati solo i primi 4 byte di ExtendedResultCode e sono nel formato F FFFFFFF in cui il primo nibble è il codice funzionalità e il resto dei bit è il codice errore.
Codici funzionalità
| Codice funzionalità | Descrizione |
|---|---|
| D | Errore generato da DO SDK |
| E | Il codice di errore è un errno |
Ad esempio:
ExtendedResultCode è -536870781
La rappresentazione esadecimale senza segno di -536870781 è FFFFFFFF E0000083.
| Ignora | Codice funzionalità | Codice di errore |
|---|---|---|
| FFFFFFFF | E | 0000083 |
0x83 in formato esadecimale è 131 in formato decimale, ovvero il valore errno per ENOLCK.
Agente di Ottimizzazione recapito
Nella tabella seguente sono elencati i codici di errore relativi al componente Ottimizzazione recapito (DO) del client di Aggiornamento dispositivi. Il componente DO è responsabile del download del contenuto di aggiornamento nel dispositivo IoT.
Il codice di errore DO può essere ottenuto esaminando le eccezioni generate in risposta a una chiamata API. Tutti i codici di errore DO possono essere identificati dal prefisso 0x80D0.
| Codice di errore | Errore stringa | Tipo | Descrizione |
|---|---|---|---|
| 0x80D01001L | DO_E_NO_SERVICE | n/d | Ottimizzazione recapito non è riuscito a fornire il servizio |
| 0x80D02002L | DO_E_DOWNLOAD_NO_PROGRESS | Processo di download | Il download di un file non ha mostrato alcun progresso entro il periodo definito |
| 0x80D02011L | DO_E_UNKNOWN_PROPERTY_ID | Processo di download | SetProperty() o GetProperty() chiamato con un ID proprietà sconosciuto |
| 0x80D02012L | DO_E_READ_ONLY_PROPERTY | Processo di download | Non è possibile chiamare SetProperty() in una proprietà di sola lettura |
| 0x80D02013L | DO_E_INVALID_STATE | Processo di download | L'azione richiesta non è consentita nello stato del processo corrente. Il processo potrebbe essere stato annullato o potrebbe esserne stato completato il trasferimento. Ora è in stato di sola lettura. |
| 0x80D02018L | DO_E_FILE_DOWNLOADSINK_UNSPECIFIED | Processo di download | Non è possibile avviare un download perché non è stato specificato alcun sink di download (file locale o interfaccia del flusso) |
| 0x80D02200L | DO_E_DOWNLOAD_NO_URI | Interfaccia IDODownload | Il download è stato avviato senza fornire un URI |
| 0x80D03805L | DO_E_BLOCKED_BY_NO_NETWORK | Condizioni transitorie | Download sospeso a causa della perdita di connettività di rete |
0 00 00000 Total 4 bytes (32 bits)
- -- -----
| | |
| | |
| | +--------- Error code (20 bits)
| |
| +------------- Component/Area code (8 bits)
|
+--------------- Facility code (4 bits)
Per altre informazioni sull'analisi dei codici, vedere Codici di risultato dell'agente di Aggiornamento dispositivi e codici di risultato estesi o Implementare un gestore del contenuto personalizzato.
Servizio contenuti di Aggiornamento dispositivi
Nella tabella seguente sono elencati i codici di errore relativi al componente del servizio contenuti del servizio Aggiornamento dispositivi. Il componente del servizio contenuti è responsabile dell'importazione del contenuto degli aggiornamenti. Altre informazioni sulla risoluzione dei problemi sono disponibili anche per l'importazione di aggiornamenti proxy.
| Codice errore | Errore stringa | Passaggi successivi |
|---|---|---|
| UpdateAlreadyExists | Esiste già un aggiornamento con la stessa identità. | Assicurarsi di aver importato un aggiornamento che non sia già stato importato in questa istanza di Aggiornamento dispositivi per hub IoT. |
| DuplicateContentImport | È stato importato più volte contemporaneamente contenuto identico. | Assicurarsi di aver importato un aggiornamento che non sia già stato importato in questa istanza di Aggiornamento dispositivi per hub IoT. |
| CannotProcessImportManifest | Si è verificato un errore durante l'elaborazione del manifesto dell'importazione. | Per informazioni sulla corretta formattazione del manifesto di importazione, vedere la documentazione sui concetti di importazione e sull'importazione degli aggiornamenti. |
| CannotDownload | Non è possibile scaricare il manifesto dell'importazione. | Verificare che l'URL per il file manifesto di importazione sia ancora valido. |
| CannotParse | Non è possibile analizzare il manifesto dell'importazione. | Controllare l'accuratezza del manifesto di importazione rispetto allo schema definito nella documentazione sull'importazione degli aggiornamenti. |
| UnsupportedVersion | La versione dello schema del manifesto dell'importazione non è supportata. | Assicurarsi che il manifesto di importazione usi lo schema più recente definito nella documentazione sull'importazione degli aggiornamenti. |
| Si è verificato un errore durante l'importazione dell'aggiornamento perché è stato superato il limite. | Non è possibile importare un provider di aggiornamenti aggiuntivo. | È stato raggiunto il limite del numero di provider diversi consentiti nell'istanza di Aggiornamento dispositivi per hub IoT. Eliminare alcuni aggiornamenti dall'istanza e riprovare. |
| Si è verificato un errore durante l'importazione dell'aggiornamento perché è stato superato il limite. | Non è possibile importare un altro nome di aggiornamento per il provider specificato. | È stato raggiunto il limite del numero di nomi diversi consentiti in un provider nell'istanza di Aggiornamento dispositivi per hub IoT. Eliminare alcuni aggiornamenti dall'istanza e riprovare. |
| Si è verificato un errore durante l'importazione dell'aggiornamento perché è stato superato il limite. | Non è possibile importare un'altra versione dell'aggiornamento per il provider e il nome specificati. | È stato raggiunto il limite del numero di versioni diverse consentite in un provider e nome nell'istanza di Aggiornamento dispositivi per hub IoT. Eliminare alcuni aggiornamenti con tale nome dall'istanza e riprovare. |
| Si è verificato un errore durante l'importazione dell'aggiornamento perché è stato superato il limite. | Non è possibile importare un provider di aggiornamenti aggiuntivo con la compatibilità specificata. or Non è possibile importare un nome di aggiornamento aggiuntivo con la compatibilità specificata. or Non è possibile importare una versione di aggiornamento aggiuntiva con la compatibilità specificata. |
Quando si definiscono le proprietà di compatibilità in un manifesto di importazione, tenere presente che Aggiornamento dispositivi per hub IoT supporta una sola combinazione di provider e nome per un determinato set di proprietà di compatibilità. Se si tenta di usare le stesse proprietà di compatibilità con più di una combinazione di provider/nome, verranno visualizzati questi errori. Per risolvere questo problema, assicurarsi che tutti gli aggiornamenti per un determinato dispositivo (come definito dalle proprietà di compatibilità) usino lo stesso provider e lo stesso nome. |
| CannotProcessUpdateFile | Si è verificato un errore durante l'elaborazione del file di origine. | |
| ContentFileCannotDownload | Non è possibile scaricare il file di origine. | Verificare che l'URL per i file di aggiornamento sia ancora valido. |
| SourceFileMalwareDetected | È stata rilevata una firma di malware nota in un file importato. | Aggiornamento dispositivi per hub IoT analizza il contenuto importato per individuare malware usando diversi meccanismi. Se viene identificata una firma di malware nota, l'importazione non riesce e viene restituito un messaggio di errore univoco. Il messaggio di errore contiene la descrizione della firma di malware e un hash di file per ogni file in cui è stata rilevata la firma. È possibile usare l'hash del file per trovare il file esatto contrassegnato e usare la descrizione della firma di malware per verificare la presenza di malware nel file. Dopo aver rimosso il malware dai file importati, è possibile avviare nuovamente il processo di importazione. |
| SourceFilePendingMalwareAnalysis | È stata rilevata una firma in un file importato che potrebbe indicare la presenza di malware. | Aggiornamento dispositivi per hub IoT analizza il contenuto importato per individuare malware usando diversi meccanismi. L'importazione ha esito negativo se una firma di analisi presenta caratteristiche di malware, anche se non esiste una corrispondenza esatta con il malware noto. In questo caso, viene restituito un messaggio di errore univoco. Il messaggio di errore contiene la descrizione della firma di malware sospetto e un hash di file per ogni file in cui è stata rilevata la firma. È possibile usare l'hash del file per trovare il file esatto contrassegnato e usare la descrizione della firma di malware per verificare la presenza di malware nel file. Dopo aver rimosso il malware dai file importati, è possibile avviare nuovamente il processo di importazione. Se si è certi che i file sono privi di malware e si continua a visualizzare questo errore, usare la procedura per Contattare il supporto tecnico Microsoft. |