Elemento RetrieveImageRequest
L'elemento di operazione RetrieveImageRequest richiesto contiene la richiesta del client di recuperare i dati di analisi dal dispositivo dopo la creazione di un processo di analisi.
Utilizzo
<wscn:RetrieveImageRequest>
child elements
</wscn:RetrieveImageRequest>
Attributi
Non ci sono attributi.
Elementi figlio
| Elemento |
|---|
| DocumentDescription |
| Jobid |
| JobToken |
Elementi padre
Non ci sono elementi padre.
Commenti
Il servizio di analisi WSD deve supportare l'elemento dell'operazione RetrieveImageRequest .
Il servizio analisi deve convalidare gli elementi JobId e JobToken forniti dal client per assicurarsi che il processo sia valido ed è stato creato dal client che richiede il recupero. Se la richiesta è valida, il servizio analisi deve rispondere con un elemento dell'operazione RetrieveImageResponse .
Questa operazione può restituire tutti i codici di errore comuni dell'operazione del servizio analisi WSD. Per altre informazioni su come segnalare errori, vedere Segnalazione errori del servizio analisi WSD.
Questa operazione potrebbe anche restituire gli errori seguenti:
ClientErrorJobIdNotFoundLo scanner non riesce a trovare un processo corrispondente al valore JobId o il valore JobId non rientra nell'intervallo definito.
Proprietà di errore Definizione [Codice] soap:Sender [Sottocodice] wscn:ClientErrorJobIdNotFound [Motivo] JobId specificato non è stato trovato. [Dettaglio] JobId: JobId non corretto ClientErrorNoImagesAvailableLo scanner non ha più immagini disponibili per il client da recuperare.
Proprietà di errore Definizione [Codice] soap:Sender [Sottocodice] wscn:ClientErrorNoImagesAvailable [Motivo] Il server non dispone di immagini disponibili per l'acquisizione. [Dettaglio] Nessuno ClientErrorInvalidJobTokenIl valore JobToken fornito non è valido per l'analisi specificata di JobId.
Proprietà di errore Definizione [Codice] soap:Sender [Sottocodice] wscn:ClientErrorInvalidJobToken [Motivo] Il valore del parametro JobToken non è valido con il parametro JobId. [Dettaglio] Nessuno ClientErrorJobCancelled
Proprietà di errore Definizione [Codice] soap:Sender [Sottocodice] wscn:ClientErrorJobCancelled [Motivo] Il processo di analisi corrente è stato annullato. [Dettaglio] Nessuno
Esempio
Nell'esempio di codice seguente viene illustrata una richiesta client per recuperare i dati dell'immagine per il processo identificato da JobId 1.
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
xmlns:soap="https://www.w3.org/2003/05/soap-envelope"
xmlns:wsa="https://schemas.xmlsoap.org/ws/2003/03/addressing"
xmlns:wscn="https://schemas.microsoft.com/windows/2006/01/wdp/scan"
soap:encodingStyle='https://www.w3.org/2002/12/soap-encoding' >
<soap:Header>
<wsa:To>AddressofScannerService</wsa:To>
<wsa:Action>
https://schemas.microsoft.com/windows/2006/01/wdp/scan/RetrieveImage
</wsa:Action>
<wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
</soap:Header>
<soap:Body>
<wscn:RetrieveImageRequest>
<wscn:JobId>1</wscn:JobId>
<wscn:JobToken>Job9876TokenString</wscn:JobToken>
<wscn:DocumentDescription>
<wscn:DocumentName>Scan001.jpg</DocumentName>
</wscn:DocumentDescription>
</wscn:RetrieveImageRequest>
</soap:Body>
</soap:Envelope>