RetrieveImageResponse-Element
Das erforderliche RetrieveImageResponse-Vorgangselement gibt die Scandaten an den Client zurück.
Verbrauch
<wscn:RetrieveImageResponse>
child elements
</wscn:RetrieveImageResponse>
Attribute
Es gibt keine Attribute.
Untergeordnete Elemente
| Element |
|---|
| ScanData |
Übergeordnete Elemente
Es gibt keine übergeordneten Elemente.
Hinweise
Der WSD-Scandienst muss das Vorgangselement RetrieveImageResponse unterstützen. Der Scan-Dienst sendet dieses Element, wenn ein Client erfolgreich ein RetrieveImageRequest-Element sendet.
Der Scandienst gibt die Scandaten als binäre Anlage mit dem Paket RetrieveImageResponse zurück. Die Antwort muss als MIME-Multipart-Related Inhaltstyp gepackt werden und den SOAP Message Transmission Optimization Mechanism [MTOM] verwenden, um die Binären Bilddaten effizient zu senden.
Die Anzahl der Bilder, die der Scan-Dienst in der resultierenden Datei zurückgibt, hängt wie folgt von der Kombination des ImagesToTransfer-Elements des ScanTicket-Elements und des Bilddateiformat-Elements ab:
- Wenn Format ein einzelnes Bildformat angibt, enthält die zurückgegebene Datei immer ein einzelnes Bild.
- Wenn Format ein Mehrseitenformat angibt, enthält die zurückgegebene Datei so viele Bilder, wie die Eingabequelle bis zum Wert von ImagesToTransfer scannen kann.
Wenn Format ein einzelnes Bildformat angibt und der Wert von ImagesToTransfer 0 oder größer als 1 ist, sendet der Client wiederholte RetrieveImageRequest-Vorgangselemente , bis der Scandienst mit einem ClientErrorNoImagesAvailable-Fehler antwortet oder bis der ImagesToTransfer-Wert erfüllt ist.
Der Scan-Dienst sollte den Auftrag mit einem JobStateReason of ImageTransferError abbrechen, wenn während der Übertragung der Bilddaten ein Kommunikationsfehler auftritt.
Beispiele
Das folgende Codebeispiel zeigt, wie der WSD-Scandienst Bilddaten an den Client sendet.
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--