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 [Subcode] 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>
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈