ValidateScanTicketRequest 元素
必要的 ValidateScanTicketRequest 作業專案可讓客戶端判斷未來掃描作業的設定是否有效。
使用方式
<wscn:ValidateScanTicketRequest>
child elements
</wscn:ValidateScanTicketRequest>
屬性
沒有屬性。
子元素
| 元素 |
|---|
| ScanTicket |
父元素
沒有父元素。
備註
用戶端可以使用 ValidateScanTicketRequest 元素來驗證各種設定變更和組合。
ScanTicket 包含用戶端在未來掃描作業中想要提交的所有設定。 ScanTicket 只能包含用戶端想要在掃描器中覆寫的處理專案，也可以包含 WSD 掃描服務中支援的每個可能元素。
如果 WSD 掃描服務已成功處理 ValidateScanTicketRequest，它會在 ValidateScanTicketResponse 作業中傳回其驗證資訊。 否則，掃描服務應該會傳回適當的錯誤碼。
這項作業可以傳回所有 常見的 WSD 掃描服務作業錯誤碼。 如需如何報告錯誤的詳細資訊，請參閱 WSD 掃描服務作業錯誤報告。
這項作業也可能傳回下列錯誤碼：
ClientErrorConflictingRequiredParameters
兩個或多個 DocumentParameters 元素之間發生衝突，每個元素的 MustHonor 屬性都設定為 true。 使用與 MustHonor set true 一起提供的所有設定會導致裝置發生衝突。 掃描服務無法解決衝突，因此 ScanTicket 被視為無效。
Fault 屬性 定義 [程序代碼] soap：Sender [子碼] wscn：ClientErrorConflictingRequiredParameters [原因] DocumentParameters 元素中的多個元素已將 MustHonor 設定為 true，但套用設為 true 的所有設定會導致掃描儀裝置發生衝突。 [詳細數據] 無
範例
下列程式代碼範例顯示有效掃描票證的驗證要求。
<?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/ValidateScanTicket
</wsa:Action>
<wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
</soap:Header>
<soap:Body>
<wscn:ValidateScanTicketRequest>
<wscn:ScanTicket>
<wscn:JobDescription>
<wscn:JobName>Photo Scan</wscn:JobName>
<wscn:JobOriginatingUserName>RogerSmith</JobOriginatingUserName>
</wscn:JobDescription>
<wscn:DocumentParameters>
<wscn:Format>dib</wscn:Format>
<wscn:InputSource>Platen</wscn:InputSource>
<wscn:ContentType>Auto</wscn:ContentType>
<wscn:InputSize>
<wscn:InputMediaSize>
<wscn:Width>3000</wscn:Width>
<wscn:Height>5000</wscn:Height>
</wscn:InputMediaSize>
</wscn:InputSize>
<wscn:Scaling>
<wscn:ScalingWidth>125</wscn:ScalingWidth>
<wscn:ScalingHeight>125</wscn:ScalingHeight>
</wscn:Scaling>
<wscn:MediaSides>
<wscn:MediaFront>
<wscn:ColorProcessing>GrayScale4</wscn:ColorProcessing>
<wscn:Resolution>
<wscn:Width>300</wscn:Width>
<wscn:Height>300</wscn:Height>
</wscn:Resolution>
</wscn:MediaFront>
</wscn:MediaSides>
</wscn:DocumentParameters>
</wscn:ScanTicket>
</wscn:ValidateScanTicketRequest>
</soap:Body>
</soap:Envelope>
下列程式代碼範例顯示無效掃描票證的驗證要求。
<?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/ValidateScanTicket
</wsa:Action>
<wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
</soap:Header>
<soap:Body>
<wscn:ValidateScanTicketRequest>
<wscn:ScanTicket>
<wscn:JobDescription>
<wscn:JobName>Photo Scan</wscn:JobName>
<wscn:JobOriginatingUserName>RogerSmith</JobOriginatingUserName>
</wscn:JobDescription>
<wscn:DocumentParameters>
<wscn:Format>jfif</wscn:Format>
<wscn:InputSource>Platen</wscn:InputSource>
<wscn:ContentType>Auto</wscn:ContentType>
<wscn:InputSize>
<wscn:DocumentSizeAutoDetect>true</wscn:DocumentSizeAutoDetect>
</wscn:InputSize>
<wscn:Scaling>
<wscn:ScalingWidth>1250</wscn:ScalingWidth>
<wscn:ScalingHeight>1250</wscn:ScalingHeight>
</wscn:Scaling>
<wscn:MediaSides>
<wscn:MediaFront>
<wscn:Resolution>
<wscn:Width>350</wscn:Width>
<wscn:Height>350</wscn:Height>
</wscn:Resolution>
<wscn:MediaFront>
<wscn:MediaSides>
</wscn:DocumentParameters>
</wscn:ScanTicket>
</wscn:ValidateScanTicketRequest>
</soap:Body>
</soap:Envelope>