Costanti di errore

I metodi dispositivi portatili Windows possono restituire un'ampia gamma di codici di errore HRESULT . Alcuni sono specifici dei dispositivi portatili Windows, mentre altri sono definiti da altri SDK o kit di conversione usati per compilare un dispositivo. Questa sezione descrive i vari codici di errore che possono essere restituiti, organizzati in base all'origine.

WPD definisce le costanti di errore seguenti.

Costante/valore	Descrizione
E_WPD_DEVICE_ALREADY_OPENED 0x802A0001	La connessione del dispositivo è già stata aperta da una chiamata precedente a IPortableDevice::Open.
E_WPD_DEVICE_IS_HUNG 0x802A0006	Il dispositivo non risponde più all'input.
E_WPD_DEVICE_NOT_OPEN 0x802A0002	La connessione del dispositivo non è ancora stata aperta da una chiamata a IPortableDevice::Open.
E_WPD_OBJECT_ALREADY_ATTACHED_TO_DEVICE 0x802A0003	L'oggetto interfaccia è già stato collegato all'interfaccia del dispositivo.
E_WPD_OBJECT_ALREADY_ATTACHED_TO_SERVICE 0x802A00CA	L'oggetto interfaccia è già stato collegato all'interfaccia IPortableDeviceService .
E_WPD_OBJECT_NOT_ATTACHED_TO_DEVICE 0x802A0004	L'oggetto interfaccia non è stato collegato al dispositivo.
E_WPD_OBJECT_NOT_ATTACHED_TO_SERVICE 0x802A00CB	L'oggetto interfaccia non è stato collegato all'interfaccia IPortableDeviceService . In genere, viene restituito se l'applicazione tenta di accedere ai metodi di un'interfaccia associata, ad esempio IPortableDeviceServiceCapabilities, dopo la chiamata di IPortableDevice::Close .
E_WPD_OBJECT_NOT_COMMITED 0x802A0005	IStream::Commit non è mai stato chiamato quando si crea un oggetto con dati in un dispositivo.
E_WPD_SERVICE_ALREADY_OPENED 0x802A00C8	La connessione al servizio è già stata aperta da una chiamata precedente a IPortableDevice::Open.
E_WPD_SERVICE_BAD_PARAMETER_ORDER 0x802A00CC	I parametri del metodo per IPortableDeviceServiceMethods::Invoke o IPortableDeviceServiceMethods::InvokeAsync non vengono impostati nell'ordine corretto. Il parametro deve essere impostato nell'ordinamento specificato da WPD_PARAMETER_ATTRIBUTE_ORDER.
E_WPD_SERVICE_NOT_OPEN 0x802A00C9	La connessione al servizio non è ancora stata aperta da una chiamata a IPortableDeviceService::Open.
E_WPD_SMS_INVALID_RECIPIENT 0x802A0064	Il destinatario specificato per un messaggio SMS non è valido.
E_WPD_SMS_INVALID_MESSAGE_BODY 0x802A0065	Il corpo di un messaggio specificato per un messaggio SMS non è valido.
E_WPD_SMS_SERVICE_UNAVAILABLE 0x802A0066	Il servizio SMS non è disponibile.

In alcuni casi, potrebbe verificarsi un errore definito in Windows Media Rights Manager SDK. Elenco di errori definiti da tale SDK nella libreria MSDN. Tuttavia, gli errori seguenti di Windows Media Rights Manager SDK non sono stati inclusi in questa documentazione.

Costante/valore	Descrizione
NS_E_DRM_DEBUGGING_NOT_ALLOWED 0xC00D2767	Non è possibile eseguire il debug durante l'accesso al contenuto protetto da DRM.
NS_E_NOT_LICENSED 0xC00D00CD	Il contenuto non è concesso in licenza.

WPD può restituire codici di errore di Windows standard all'applicazione. Nella tabella seguente sono elencati i codici di errore standard di Windows più comunemente usati e le condizioni di errore comuni quando si usa un dispositivo WPD.

I codici di errore Win32 vengono convertiti in HRESULTusando la macro HRESULT_FROM_WIN32 .

Costante/valore	Descrizione
ERROR_ACCESS_DENIED 0x80070005	Può essere usato per indicare che non è possibile modificare o eliminare un oggetto o una proprietà di sola lettura. Può essere usato per indicare che l'oggetto viene accessibile all'esterno del relativo ambito, ad esempio un oggetto figlio che rientra all'esterno della gerarchia di un servizio dispositivo. Può essere usato per indicare che l'applicazione non dispone dell'accesso (ad esempio, se il controllo di accesso ai dispositivi è limitato da Criteri di gruppo) per inviare comandi WPD al dispositivo.
ERROR_ARITHMETIC_OVERFLOW 0x80070216	Può essere usato per indicare che il numero di elementi in una matrice di dati ha superato i limiti (ULONGLONG).
ERROR_BUSY 0x800700AA	Può essere usato per indicare che il dispositivo sta elaborando un'altra operazione. Le applicazioni devono attendere il completamento dell'operazione prima di ripetere i tentativi.
ERROR_CANCELLED 0x800704C7	Un comando inviato al dispositivo è stato interrotto a causa di un annullamento, ad esempio chiamando uno dei metodi Cancel nell'API WPD.
ERROR_DATATYPE_MISMATCH 0x8007070C	Può essere usato per indicare che un pacchetto di dati non valido è stato ricevuto dal dispositivo.
ERROR_DEVICE_IN_USE 0x80070964	Per un dispositivo MTP/IP, indica che la connessione non è riuscita a inizializzare perché il dispositivo è in uso.
ERROR_DEVICE_NOT_CONNECTE 0x8007048F	Il dispositivo è stato disconnesso o scollegato.
ERROR_DIR_NOT_EMPTY 0x80070091	Può essere usato per indicare che è stata chiamata un'eliminazione non ricorsiva per un oggetto con elementi figlio. L'applicazione deve usare il flag di eliminazione ricorsiva in IPortableDeviceContent::D elete.
ERROR_EMPTY 0x800710D2	Può essere usato per indicare che il dispositivo non è riuscito a inviare dati delle risorse quando i dati delle risorse erano previsti (ad esempio un'icona di anteprima o dispositivo). Questo indica in genere un errore nel dispositivo.
ERROR_FILE_NOT_FOUND 0x80070002	Può essere usato per indicare che il dispositivo è stato disconnesso o scollegato.
ERROR_GEN_FAILURE 0x8007001F	Può essere usato per indicare che il dispositivo ha smesso di rispondere (bloccato) o che si è verificato un errore generale nel dispositivo. Potrebbe essere necessario reimpostare manualmente il dispositivo.
ERROR_INVALID_DATA 0x8007000D	Può essere usato per indicare che i dati inviati o ricevuti dal dispositivo non possono essere analizzati correttamente. Ciò può indicare un errore sul lato dispositivo o un errore di trasporto. Se le operazioni del fornitore MTP vengono inviate al dispositivo, questo errore può indicare che i parametri dell'operazione specificati non sono validi per VARTYPE.
ERROR_INVALID_DATATYPE 0x8007070C	Può essere utilizzato per indicare che l'oggetto VARTYPE specificato non è valido per una determinata proprietà.
ERROR_INVALID_FUNCTION 0x80070001	È stata effettuata una richiesta di scrittura a una risorsa nel dispositivo aperto in modalità di lettura usando IPortableDeviceResources::GetStream oppure è stata effettuata una richiesta di lettura a una risorsa aperta per Scrittura o Creazione.
ERROR_INVALID_OPERATION 0x800710DD	Viene chiamata un'eliminazione non ricorsiva per un oggetto con elementi figlio.
ERROR_INVALID_PARAMETER 0x80070057	Il parametro fornito dall'applicazione non è valido.
ERROR_INVALID_TIME 0x8007076D	Può essere utilizzato per indicare che una conversione di una proprietà datetime non è riuscita.
ERROR_IO_DEVICE 0x8007045D	Può essere usato per indicare che il dispositivo ha smesso di rispondere (bloccato). Potrebbe essere necessario reimpostare manualmente il dispositivo.
ERROR_NOT_FOUND 0x80070490	Può essere usato per indicare che il dispositivo supporta una proprietà, ma il valore della proprietà è attualmente vuoto o non inizializzato. Può essere utilizzato per indicare che il contesto interno per un'operazione a esecuzione prolungata non esiste più, perché l'operazione è stata completata o è stata annullata. Esempi di tali operazioni includono proprietà bulk, enumerazione di oggetti, trasferimento e richiamo dei metodi del servizio dispositivi. Le applicazioni devono ripetere l'operazione dall'inizio. Può essere utilizzato per indicare che l'oggetto specificato non esiste. L'oggetto figlio può essere esterno alla gerarchia del servizio del dispositivo.
ERROR_NOT_READY 0x80070015	Può essere utilizzato per indicare che un'operazione non viene inizializzata correttamente. Ciò indica in genere un errore interno o che l'applicazione usa un handle di dispositivo non aggiornato. L'applicazione deve ripetere l'operazione dall'inizio o riaprire il dispositivo.
ERROR_NOT_SUPPORTED 0x80070032	Può essere usato per indicare che una proprietà o un comando non è supportato dal dispositivo.
ERROR_OPERATION_ABORTED 0x800703E3	Un comando inviato al dispositivo è stato interrotto a causa di un annullamento manuale, ad esempio chiamando uno dei metodi Cancel nell'API WPD.
ERROR_READ_FAULT 0x8007001E	Può essere usato per indicare che il dispositivo non invia la quantità corretta di dati.
ERROR_RESOURCE_NOT_AVAILABLE 0x8007138E	Può essere usato per indicare che una risorsa (ad esempio un'anteprima o un'icona) non è presente nel dispositivo.
ERROR_SEM_TIMEOUT 0x80070079	Può essere usato per indicare che il dispositivo ha smesso di rispondere (bloccato). Potrebbe essere necessario reimpostare manualmente il dispositivo.
ERROR_TIMEOUT 0x800705B4	Può essere usato per indicare che il dispositivo ha smesso di rispondere (bloccato). Potrebbe essere necessario reimpostare manualmente il dispositivo.
ERROR_UNSUPPORTED_TYPE 0x8007065E	Può essere usato per indicare che il formato specificato non è supportato dal dispositivo.
ERROR_WRITE_FAULT 0x8007001D	Può essere usato per indicare che l'applicazione non è riuscita a inviare la quantità richiesta di dati al dispositivo.
WSAETIMEDOUT 0x8007274c	Per un dispositivo MTP/IP, indica che la connessione al dispositivo è scaduta. Potrebbe essere necessario riconnettere manualmente il dispositivo.

Codici di errore del protocollo di trasferimento multimediale

I dispositivi che supportano Media Transfer Protocol (MTP) possono restituire i codici di errore seguenti. La maggior parte di questi codici di errore implica un errore nello stack MTP (comunicazione tra il driver di classe MTP e il dispositivo), ma è utile per diagnosticare la situazione di errore.

Descrizione HRESULT	Codice di risposta MTP	Descrizione del codice di risposta MTP	Dettagli
0x80042003	0x2003	Sessione non aperta	Indica che l'handle di sessione dell'operazione non è una sessione attualmente aperta. Questo indica un errore interno nello stack MTP.
0x80042004	0x2004	TransactionID non valido	Indica che TransactionID è zero o non fa riferimento a una transazione valida. Questo indica un errore interno nello stack MTP.
0x80042005	0x2005	Operazione non supportata	Indica che il codice dell'operazione sembra essere un codice valido, ma il dispositivo non supporta l'operazione. Questo indica un errore interno nello stack MTP.
0x80042006	0x2006	Parametro non supportato	Indica che è stato specificato un parametro diverso da zero in combinazione con l'operazione e il parametro non viene usato per tale operazione. Questo indica un errore interno nello stack MTP.
0x80042007	0x2007	Trasferimento incompleto	Indica che il trasferimento non è stato completato e i dati trasferiti devono essere rimossi. Questa risposta non corrisponde a una transazione annullata.
0x80042008	0x2008	StorageID non valido	Indica che un ID di archiviazione inviato con un'operazione non fa riferimento a un archivio valido effettivo presente nel dispositivo. Questo indica un errore interno nello stack MTP.
0x80042009	0x2009	ObjectHandle non valido	Indica che un handle di oggetto non fa riferimento a un oggetto effettivo presente nel dispositivo. L'applicazione deve enumerare nuovamente le risorse di archiviazione.
0x8004200A	0x200A	DeviceProp non supportato	Indica che il codice della proprietà del dispositivo sembra essere un codice valido, ma tale proprietà non è supportata dal dispositivo. Questo indica un errore interno nello stack MTP.
0x8004200B	0x200B	ObjectFormatCode non valido	Indica che il dispositivo non supporta il codice di formato oggetto specifico fornito nel contesto specificato.
0x80042012	0x2012	Eliminazione parziale	Indica che solo un subset delle risorse di archiviazione indicate per l'eliminazione è stato effettivamente eliminato, perché alcuni sono stati protetti da scrittura o in archivi di sola lettura.
0x80042013	0x2013	Store non disponibile	Indica che l'archivio (o l'archivio che contiene l'oggetto indicato) non è fisicamente disponibile. Ciò può essere causato dall'espulsione dei supporti. Questa risposta non verrà usata per indicare che l'archivio è occupato.
0x80042014	0x2014	Specifica per formato non supportato	Indica che l'operazione ha tentato di specificare l'azione solo sugli oggetti di un formato specifico e che tale funzionalità non è supportata. L'operazione deve essere tentata di nuovo senza specificare in base al formato. Qualsiasi risposta di questa natura deduce che qualsiasi tentativo futuro di specificare in base al formato con l'operazione indicata genererà la stessa risposta. Questo indica un errore interno nello stack MTP.
0x80042015	0x2015	Nessun objectinfo valido	Indica che l'host non ha fornito informazioni valide sull'oggetto al dispositivo prima del trasferimento dell'oggetto. Questo indica un errore interno nello stack MTP.
0x80042016	0x2016	Formato del codice non valido	Indica che il codice dati non ha il formato corretto e pertanto non è valido. Questo indica un errore interno nello stack MTP.
0x80042017	0x2017	Codice fornitore sconosciuto	Il dispositivo non sa come gestire il codice esteso del fornitore.
0x8004201A	0x201A	ParentObject non valido	Indica che l'oggetto non è un oggetto padre valido. Questo indica un errore interno nello stack MTP.
0x8004201B	0x201B	Formato DeviceProp non valido	Indica che è stato effettuato un tentativo di impostare una proprietà del dispositivo, ma i dati non sono di dimensioni o formato corretti. Questo indica un errore interno nello stack MTP.
0x8004201C	0x201C	Valore DeviceProp non valido	Indica che è stato effettuato un tentativo di impostare una proprietà del dispositivo su un valore non consentito dal dispositivo. Questo indica un errore interno nello stack MTP
0x8004201E	0x201E	Sessione già aperta	Indica che l'host ha tentato di aprire la sessione mentre una sessione è già aperta. Questo indica un errore interno nello stack MTP.
0x8004201F	0x201F	Transazione annullata	Può essere utilizzato per indicare che l'operazione è stata interrotta a causa dell'annullamento manuale.
0x80042020	0x2020	Specifica della destinazione non supportata	Indica che il dispositivo non supporta la specifica della destinazione da parte dell'host. Questo indica un errore interno nello stack MTP.
0x8004A801	0xA801	Invalid_ObjectPropCode	Indica che il dispositivo non supporta il codice proprietà oggetto inviato in questo contesto. Questo indica un errore interno nello stack MTP.
0x8004A802	0xA802	Invalid_ObjectProp_Format	Indica che una proprietà dell'oggetto inviata al dispositivo si trova in una dimensione o un tipo non supportato. Questo indica un errore interno nello stack MTP.
0x8004A803	0xA803	Invalid_ObjectProp_Value	Indica che una proprietà dell'oggetto inviata al dispositivo è il tipo corretto, ma contiene un valore non supportato. Questo indica un errore interno nello stack MTP.
0x8004A804	0xA804	Invalid_ObjectReference	Indica che un riferimento all'oggetto inviato non è valido. Il riferimento contiene un handle di oggetti non presente nel dispositivo o il tentativo di riferimento da impostare non è supportato nel contesto. Ciò può essere dovuto a un errore nello stack MTP o a causa dell'applicazione usando un oggetto di archiviazione non aggiornato.
0x8004A806	0xA806	Invalid_Dataset	Indica che il set di dati inviato nella fase dati di questa operazione non è valido. Questo indica un errore interno nello stack MTP.
0x8004A807	0xA807	Object_Too_Large	Indica che l'oggetto da inviare non può essere archiviato nel file system del dispositivo. Questa operazione non verrà restituita quando lo spazio non è sufficiente nella risorsa di archiviazione.
0x8004A301	0xA301	Invalid_ServiceID	Indica che un ID servizio inviato con un'operazione non fa riferimento a un servizio valido effettivo presente nel dispositivo. Questo indica un errore interno nello stack MTP.
0x8004A302	0xA302	Invalid_ServicePropCode	Indica che il dispositivo non supporta il codice della proprietà del servizio inviato in questo contesto. Questo indica un errore interno nello stack MTP.

Requisiti

Requisito	Valore
Intestazione	PortableDevice.h

Vedi anche

Costanti