次の方法で共有

GetScannerElementsRequest 要素

  • [アーティクル]

必要となる GetScannerElementsRequest 要素は、クライアントがスキャナーに関する情報を要求するためのものです。

使用方法

<wscn:GetScannerElementsRequest>
  child elements
</wscn:GetScannerElementsRequest>

属性

属性はありません。

子要素

要素
RequestedElements

親要素

親要素は存在しません。

解説

WSD スキャン サービスは、GetScannerElementsRequest 操作に対応している必要があります。

クライアントは GetScannerElementsRequest を呼び出して、スキャン サービスのスキーマの標準要素とベンダー拡張要素を検出できます。 クライアントで使用できる情報には、デバイスのルート レベルでアクセスできるスキャナー データの任意の部分が含まれます。 この情報には、説明、構成、状態、既定のスキャン チケット、およびスキャン サービスのベンダー拡張機能が含まれます。

スキャン サービスが GetScannerElementsRequest を正常に処理すると、要求された情報を含む GetScannerElementsResponse 操作が返されます。 それ以外の場合、スキャン サービスは適切なエラー コードを返す必要があります。

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

例

次のコード例では、クライアントは、スキャナーの説明を照会する単一の QName 値 (wscn:ScannerDescription) を指定します。

<?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/GetScannerElements
    </wsa:Action>
    <wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
  </soap:Header>

  <soap:Body>
    <wscn:GetScannerElementsRequest>
      <wscn:RequestedElements>
        <wscn:Name>wscn:ScannerDescription</wscn:Name>
      </wscn:RequestedElements>
    </wscn:GetScannerElementsRequest>
  </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/GetScannerElements
    </wsa:Action>
    <wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
  </soap:Header>

  <soap:Body>
    <wscn:GetScannerElementsRequest>
      <wscn:RequestedElements>
        <wscn:Name>wscn:ScannerStatus</wscn:Name>
      </wscn:RequestedElements>
    </wscn:GetScannerElementsRequest>
  </soap:Body>
</soap:Envelope>

次のコード例では、クライアントは 2 つの QName 値を指定します。 最初の QName は wscn:ScannerConfiguration で、2 番目の QName は無効です。

<?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"
  xmlns:ihv="https://www.example.com/extension"
  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/GetScannerElements
    </wsa:Action>
    <wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
  </soap:Header>

  <soap:Body>
    <wscn:GetScannerElementsRequest>
      <wscn:RequestedElements>
        <wscn:Name>wscn:ScannerConfiguration</wscn:Name>
        <wscn:Name>ihv:InvalidRequestEntry</wscn:Name>
      </wscn:RequestedElements>
    </wscn:GetScannerElementsRequest>
  </soap:Body>
</soap:Envelope>

関連項目

GetScannerElementsResponse

RequestedElements