RetrieveImageResponse 元素
必要的 RetrieveImageResponse 作業專案會將掃描數據傳回給用戶端。
使用方式
<wscn:RetrieveImageResponse>
child elements
</wscn:RetrieveImageResponse>
屬性
沒有屬性。
子元素
| 元素 |
|---|
| ScanData |
父元素
沒有父元素。
備註
WSD 掃描服務必須支援 RetrieveImageResponse 作業專案。 當用戶端成功傳送 RetrieveImageRequest 元素時，掃描服務會傳送這個專案。
掃描服務會將掃描數據當做具有 RetrieveImageResponse 封包的二進位附件傳回。 回應必須封裝為MIME Multipart-Related 內容類型，並使用SOAP訊息傳輸優化機制[MTOM] 有效率地傳送二進位影像數據。
掃描服務在結果檔案中傳回的影像數目取決於 ScanTicket 的 ImagesToTransfer 元素和圖像檔 Format 元素的組合，如下所示：
- 如果 Format 指定單一影像格式，傳回的檔案一律會包含單一影像。
- 如果 Format 指定多頁格式，傳回的檔案將包含最多輸入來源可以掃描到 ImagesToTransfer 值的影像。
如果 Format 指定單一影像格式，且 ImagesToTransfer 的值是 0 或大於 1，則用戶端會傳送重複的 RetrieveImageRequest 作業元素，直到掃描服務以 ClientErrorNoImagesAvailable 錯誤回復，或直到符合 ImagesToTransfer 值為止。
如果影像數據傳輸期間發生通訊錯誤，掃描服務應中止作業與 ImageTransferError 的 JobStateReason。
範例
下列程式代碼範例示範 WSD 掃描服務如何將影像數據傳送至用戶端。
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--