Elemento RetrieveImageRequest
El elemento de operación RetrieveImageRequest necesario contiene la solicitud del cliente para recuperar los datos de examen del dispositivo después de crear un trabajo de examen.
Uso
<wscn:RetrieveImageRequest>
child elements
</wscn:RetrieveImageRequest>
Atributos
No hay atributos.
Elementos secundarios
| Elemento |
|---|
| DocumentDescription |
| JobId |
| JobToken |
Elementos primarios
No hay elementos primarios.
Comentarios
El servicio de examen de WSD debe admitir el elemento de operación RetrieveImageRequest .
El servicio scan debe validar los elementos JobId y JobToken que proporciona el cliente para asegurarse de que el trabajo es válido y lo creó el cliente que solicita la recuperación. Si la solicitud es válida, el servicio scan debe responder con un elemento de operación RetrieveImageResponse .
Esta operación puede devolver todos los códigos de error comunes de operación del servicio de examen de WSD. Para obtener más información sobre cómo notificar errores, vea Informe de errores de la operación del servicio de examen de WSD.
Esta operación también puede devolver los siguientes errores:
ClientErrorJobIdNotFoundEl analizador no encuentra un trabajo que coincida con el valor jobId o el valor jobId no está dentro del intervalo definido.
Fault (propiedad) Definición [Código] soap:Sender [Subcódigo] wscn:ClientErrorJobIdNotFound [Motivo] No se encontró el JobId especificado. [Detalle] JobId: JobId incorrecto ClientErrorNoImagesAvailableEl escáner no tiene más imágenes disponibles para que el cliente recupere.
Fault (propiedad) Definición [Código] soap:Sender [Subcódigo] wscn:ClientErrorNoImagesAvailable [Motivo] El servidor no tiene imágenes disponibles para adquirir. [Detalle] None ClientErrorInvalidJobTokenEl valor jobToken proporcionado no es válido para el jobId de examen especificado.
Fault (propiedad) Definición [Código] soap:Sender [Subcódigo] wscn:ClientErrorInvalidJobToken [Motivo] El valor del parámetro JobToken no es válido con el parámetro JobId. [Detalle] None ClientErrorJobCancelled
Fault (propiedad) Definición [Código] soap:Sender [Subcódigo] wscn:ClientErrorJobCancelled [Motivo] Se ha cancelado el trabajo de examen actual. [Detalle] None
Ejemplos
En el ejemplo de código siguiente se muestra una solicitud de cliente para recuperar datos de imagen para el trabajo identificado por 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>