次の方法で共有

ValidateScanTicketRequest 要素

  • [アーティクル]

必要な ValidateScanTicketRequest 操作要素を使用すると、クライアントは将来のスキャン操作の設定が有効かどうかを判断できます。

使用方法

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

属性

属性はありません。

子要素

要素
ScanTicket

親要素

親要素は存在しません。

解説

クライアントは ValidateScanTicketRequest 要素を使用して、さまざまな設定の変更と組み合わせを検証できます。

ScanTicket には、クライアントが今後のスキャン操作で送信するすべての設定が含まれます。 ScanTicket には、クライアントがスキャナーでオーバーライドする処理要素のみを含めることができます。または、WSD スキャン サービスでサポートされているすべての可能な要素を含めることができます。

WSD スキャン サービスが ValidateScanTicketRequest を正常に処理すると、ValidateScanTicketResponse 操作でその検証情報が返されます。 それ以外の場合、スキャン サービスは適切なエラー コードを返す必要があります。

この操作は、すべての一般的な WSD スキャン サービス操作エラー コードを返すことができます。 エラーを報告する方法の詳細については、「WSD スキャン サービス操作エラー報告」を参照してください。

この操作では、次のエラー コードが返される場合もあります。

  • ClientErrorConflictingRequiredParameters

    MustHonor 属性が true に設定されている複数の DocumentParameters 要素間で競合があります。 MustHonor が true に設定された状態で指定されたすべての設定を使用すると、デバイスで競合が発生します。 スキャン サービスはこの競合を解決できないため、ScanTicket は無効と見なされます。

    エラー プロパティ Definition
    [コード] 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