RetrieveImageRequest 元素
必要的 RetrieveImageRequest 作業元素包含用戶端在建立掃描作業之後從裝置擷取掃描資料的要求。
使用方式
<wscn:RetrieveImageRequest>
child elements
</wscn:RetrieveImageRequest>
屬性
沒有屬性。
子元素
| 元素 |
|---|
| DocumentDescription |
| JobId |
| JobToken |
父元素
沒有父元素。
備註
WSD 掃描服務必須支援 RetrieveImageRequest 作業專案。
掃描服務必須驗證用戶端所提供的 JobId 和 JobToken 元素，以確保作業有效，而且是由要求擷取的用戶端所建立。 如果要求有效，掃描服務必須回應 RetrieveImageResponse 作業專案。
這項作業可以傳回所有 常見的 WSD 掃描服務作業錯誤碼。 如需如何報告錯誤的詳細資訊，請參閱 WSD 掃描服務作業錯誤報告。
這項作業也可能傳回下列錯誤：
ClientErrorJobIdNotFound掃描器找不到符合 JobId 值或 JobId 值不在定義範圍內的作業。
Fault 屬性 定義 [程序代碼] soap：Sender [子碼] wscn：ClientErrorJobIdNotFound [原因] 找不到指定的 JobId。 [詳細數據] JobId：不正確的 JobId ClientErrorNoImagesAvailable掃描器沒有可供用戶端擷取的更多影像。
Fault 屬性 定義 [程序代碼] soap：Sender [子碼] wscn：ClientErrorNoImagesAvailable [原因] 伺服器沒有映像可供取得。 [詳細數據] 無 ClientErrorInvalidJobToken提供的 JobToken 值對指定的掃描 JobId 無效。
Fault 屬性 定義 [程序代碼] soap：Sender [子碼] wscn：ClientErrorInvalidJobToken [原因] JobToken 參數值與 JobId 參數無效。 [詳細數據] 無 ClientErrorJobCancelled
Fault 屬性 定義 [程序代碼] soap：Sender [子碼] wscn：ClientErrorJobCancelled [原因] 目前的掃描作業已取消。 [詳細數據] 無
範例
下列程式代碼範例顯示用戶端要求，以擷取 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>