Элемент GetScannerElementsRequest

Статья
02/02/2024

Обязательный элемент GetScannerElementsRequest позволяет клиенту запрашивать сведения о сканере.

Использование

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

Атрибуты

Атрибуты отсутствуют.

Дочерние элементы

Элемент
RequestedElements

Родительские элементы

Родительские элементы отсутствуют.

Клиент может вызвать Метод 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, а второе — недопустимое.

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

Поделиться через