Elemento RetrieveImageResponse
El elemento de operación RetrieveImageResponse necesario devuelve los datos de examen al cliente.
Uso
<wscn:RetrieveImageResponse>
child elements
</wscn:RetrieveImageResponse>
Atributos
No hay atributos.
Elementos secundarios
| Elemento |
|---|
| ScanData |
Elementos primarios
No hay elementos primarios.
Comentarios
El servicio de examen de WSD debe admitir el elemento de operación RetrieveImageResponse . El servicio Scan envía este elemento cuando un cliente envía correctamente un elemento RetrieveImageRequest .
El servicio Scan devuelve los datos de examen como datos adjuntos binarios con el paquete RetrieveImageResponse . La respuesta debe empaquetarse como un tipo de contenido MIME Multipart-Related y usar el mecanismo de optimización de transmisión de mensajes SOAP [MTOM] para enviar eficazmente los datos de la imagen binaria.
El número de imágenes que devuelve el servicio scan en el archivo resultante depende de la combinación del elemento ImagesToTransfer del elemento ScanTicket y del elemento Image File Format de la siguiente manera:
- Si Format especifica un único formato de imagen, el archivo devuelto siempre contendrá una sola imagen.
- Si Format especifica un formato de varias páginas, el archivo devuelto contendrá tantas imágenes como el origen de entrada pueda examinar hasta el valor de ImagesToTransfer.
Si Format especifica un único formato de imagen y el valor de ImagesToTransfer es 0 o mayor que 1, el cliente enviará elementos de operación RetrieveImageRequest repetidos hasta que el servicio Scan responda con un error ClientErrorNoImagesAvailable o hasta que se cumpla el valor ImagesToTransfer .
El servicio scan debe anular el trabajo con un jobStateReason de ImageTransferError si se produce un error de comunicación durante la transferencia de los datos de imagen.
Ejemplos
En el ejemplo de código siguiente se muestra cómo el servicio de examen de WSD envía datos de imagen al cliente.
mime-version: 1.0
Content-Type: multipart/related;
type=application/xop+xml;
boundary=4aa7d814-adc1-47a2-8e1c-07585b9892a4;
start="<14629f74-2047-436c-8046-5cac76d280fc@uuid>";
startinfo=application/soap+xml
--4aa7d814-adc1-47a2-8e1c-07585b9892a4
Content-Type: application/xop+xml; type="application/soap+xml"
charset=UTF-8
Content-Transfer-Encoding: binary
Content-ID: <14629f74-2047-436c-8046-5cac76d280fc@uuid>
<?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:xop="https://www.w3.org/2003/12/xop/include"
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>https://schemas.xmlsoap.org/ws/2003/03/addressing/role/anonymous</wsa:To>
<wsa:Action>
https://schemas.microsoft.com/windows/2006/01/wdp/scan/RetrieveImage
</wsa:Action>
<wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
<wsa:RelatesTo>uuid:MsgIdOfTheRetrieveImageRequest</wsa:RelatesTo>
</soap:Header>
<soap:Body>
<wscn:RetrieveImageResponse>
<wscn:ScanData>
<xop:Include href="cid:1c696bd7-005a-48d9-9ee9-9adca11f8892@uuid" />
</wscn:ScanData>
</wscn:RetrieveImageResponse>
</soap:Body>
</soap:Envelope>
--4aa7d814-adc1-47a2-8e1c-07585b9892a4
Content-Type: image/jpeg;
Content-Transfer-Encoding: binary
Content-ID: <1c696bd7-005a-48d9-9ee9-9adca11f8892@uuid >
Binary Scan Data
--4aa7d814-adc1-47a2-8e1c-07585b9892a4--