ValidateScanTicketRequest-Element

Mit dem erforderlichen ValidateScanTicketRequest-Vorgangselement kann ein Client ermitteln, ob die Einstellungen für zukünftige Scanvorgänge gültig sind.

Verwendung

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

Attribute

Es gibt keine Attribute.

Untergeordnete Elemente

Element
ScanTicket

Übergeordnete Elemente

Es gibt keine übergeordneten Elemente.

Bemerkungen

Ein Client kann das ValidateScanTicketRequest-Element verwenden, um verschiedene Einstellungsänderungen und Kombinationen zu überprüfen.

ScanTicket enthält alle Einstellungen, die der Client in einem zukünftigen Scanvorgang übermitteln möchte. ScanTicket kann nur die Verarbeitungselemente enthalten, die der Client im Scanner außer Kraft setzen möchte, oder es kann jedes mögliche Element enthalten, das im WSD-Scandienst unterstützt wird.

Wenn der WSD-Scandienst ValidateScanTicketRequest erfolgreich verarbeitet, werden seine Überprüfungsinformationen in einem ValidateScanTicketResponse-Vorgang zurückgegeben. Andernfalls sollte der Scandienst die entsprechenden Fehlercodes zurückgeben.

Dieser Vorgang kann alle allgemeinen Fehlercodes des WSD-Scandiensts zurückgeben. Weitere Informationen zum Melden von Fehlern finden Sie unter WSD Scan Service Operation Error Reporting.

Dieser Vorgang kann auch den folgenden Fehlercode zurückgeben:

• ClientErrorConflictingRequiredParameters

  Es gibt einen Konflikt zwischen zwei oder mehr DocumentParameters-Elementen, die jeweils das MustHonor-Attribut auf "true" festgelegt haben. Wenn Sie alle Einstellungen verwenden, die mit MustHonor set "true" bereitgestellt werden, tritt ein Konflikt auf dem Gerät auf. Der Scandienst kann diesen Konflikt nicht lösen, sodass das ScanTicket als ungültig eingestuft wird.

  Fault-Eigenschaft	Definition
  [Code]	soap:Sender
  [Untercode]	wscn:ClientErrorConflictingRequiredParameters
  [Grund]	Mehrere Elemente im DocumentParameters-Element haben MustHonor auf "true" festgelegt, aber das Anwenden aller einstellungen, die auf "true" festgelegt sind, führt zu einem Konflikt im Scannergerät.
  [Detail]	Nichts

Beispiele

Das folgende Codebeispiel zeigt eine Überprüfungsanforderung für ein gültiges Scanticket.

<?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>

Das folgende Codebeispiel zeigt eine Überprüfungsanforderung für ein ungültiges Scanticket.

<?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>

Siehe auch

ScanTicket