Элемент ValidateScanTicketRequest

Статья
05/04/2023

Обязательный элемент операции ValidateScanTicketRequest позволяет клиенту определить, являются ли допустимыми параметры для будущих операций сканирования.

Использование

<wscn:ValidateScanTicketRequest>
  child elements
</wscn:ValidateScanTicketRequest>

Атрибуты

Атрибуты отсутствуют.

Дочерние элементы

Элемент
ScanTicket

Родительские элементы

Родительские элементы отсутствуют.

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>

См. также раздел

ScanTicket

ValidateScanTicketRequest

Поделиться через