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>

在下面的代码示例中,客户端指定两个 QName 值。 第一个 QName 是 wscn: ScannerConfiguration,第二个 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