Элемент 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>