通过

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>

另请参阅

ScanTicket

ValidateScanTicketRequest