Элемент ValidateScanTicketRequest

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

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

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

Атрибуты

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

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

Элемент
ScanTicket

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

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

Замечания

Клиент может использовать элемент ValidateScanTicketRequest для проверки различных изменений и сочетаний параметров.

ScanTicket содержит все параметры, которые клиент хочет отправить в будущей операции сканирования. ScanTicket может содержать только элементы обработки, которые клиент хочет переопределить в сканере, или содержать все возможные элементы, поддерживаемые в службе проверки WSD.

Если служба проверки WSD успешно обрабатывает ValidateScanTicketRequest, она возвращает сведения о проверке в операции ValidateScanTicketResponse . В противном случае служба сканирования должна возвращать соответствующие коды ошибок.

Эта операция может возвращать все распространенные коды ошибок службы сканирования WSD. Дополнительные сведения о том, как сообщать об ошибках, см. в статье WSD Scan Service Operation Error Reporting.

Эта операция также может возвращать следующий код ошибки:

• ClientErrorConflictingRequiredParameters

  Существует конфликт между двумя или несколькими элементами DocumentParameters, для каждого из которых задан атрибут MustHonor значение true. Использование всех параметров, предоставленных с помощью набора MustHonor, приводит к конфликту на устройстве. Служба сканирования не может устранить этот конфликт, поэтому ScanTicket считается недопустимым.

  Свойство сбоя	Определение
  [Код]	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