Élément RetrieveImageResponse
L’élément d’opération RetrieveImageResponse requis retourne les données d’analyse au client.
Utilisation
<wscn:RetrieveImageResponse>
child elements
</wscn:RetrieveImageResponse>
Attributs
Il n’y a pas d’attributs.
Éléments enfants
| Élément |
|---|
| ScanData |
Éléments parents
Il n’y a pas d’éléments parents.
Remarques
Le service d’analyse WSD doit prendre en charge l’élément d’opération RetrieveImageResponse . Le service d’analyse envoie cet élément lorsqu’un client envoie avec succès un élément RetrieveImageRequest .
Le service d’analyse retourne les données d’analyse en tant que pièce jointe binaire avec le paquet RetrieveImageResponse . La réponse doit être empaquetée en tant que type de contenu MIME Multipart-Related et utiliser le mécanisme d’optimisation de la transmission de messages SOAP [MTOM] pour envoyer efficacement les données d’image binaires.
Le nombre d’images retournées par le service d’analyse dans le fichier résultant dépend de la combinaison de l’élément ImagesToTransfer de l’élément ScanTicket et de l’élément Format de fichier image comme suit :
- Si Format spécifie un format d’image unique, le fichier retourné contiendra toujours une seule image.
- Si Format spécifie un format multipage, le fichier retourné contient autant d’images que la source d’entrée peut analyser jusqu’à la valeur ImagesToTransfer.
Si Format spécifie un format d’image unique et que la valeur de ImagesToTransfer est 0 ou supérieure à 1, le client envoie des éléments d’opération RetrieveImageRequest répétés jusqu’à ce que le service d’analyse réponde avec une erreur ClientErrorNoImagesAvailable ou jusqu’à ce que la valeur ImagesToTransfer soit remplie.
Le service d’analyse doit abandonner le travail avec un JobStateReasond’ImageTransferError en cas d’erreur de communication pendant le transfert des données d’image.
Exemples
L’exemple de code suivant montre comment le service d’analyse WSD envoie des données d’image au client.
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--