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

Элемент RetrieveImageRequest

Обязательный элемент операции RetrieveImageRequest содержит запрос клиента на получение данных сканирования с устройства после создания задания сканирования.

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

<wscn:RetrieveImageRequest>
  child elements
</wscn:RetrieveImageRequest>

Атрибуты

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

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

Элемент
Описание документа
JobId
JobToken

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

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

Комментарии

Служба сканирования WSD должна поддерживать элемент операции RetrieveImageRequest .

Служба сканирования должна проверить элементы JobId и JobToken , предоставляемые клиентом, чтобы убедиться, что задание является допустимым и было создано клиентом, запрашивающим получение. Если запрос является допустимым, служба сканирования должна ответить с помощью элемента операции RetrieveImageResponse .

Эта операция может возвращать все распространенные коды ошибок службы сканирования WSD. Дополнительные сведения о том, как сообщать об ошибках, см. в разделе Отчеты об ошибках службы сканирования WSD.

Эта операция также может возвращать следующие ошибки:

  • ClientErrorJobIdNotFoundСканеру не удается найти задание, соответствующее значению JobId, или значение JobId не находится в заданном диапазоне.

    Свойство fault Определение
    [Код] soap:Sender
    [Подкод] wscn:ClientErrorJobIdNotFound
    [Причина] Указанный идентификатор JobId не найден.
    [Подробности] JobId: неверный идентификатор задания

  • ClientErrorNoImagesAvailableВ средстве проверки нет дополнительных образов, доступных для получения клиентом.

    Свойство fault Определение
    [Код] soap:Sender
    [Подкод] wscn:ClientErrorNoImagesAvailable
    [Причина] На сервере нет доступных образов для получения.
    [Подробности] Нет

  • ClientErrorInvalidJobTokenУказанное значение JobToken недопустимо для указанного jobId сканирования.

    Свойство fault Определение
    [Код] soap:Sender
    [Подкод] wscn:ClientErrorInvalidJobToken
    [Причина] Значение параметра JobToken недопустимо для параметра JobId.
    [Подробности] Нет

  • ClientErrorJobCancelled

    Свойство fault Определение
    [Код] soap:Sender
    [Подкод] wscn:ClientErrorJobCancelled
    [Причина] Текущее задание сканирования отменено.
    [Подробности] Нет

Примеры

В следующем примере кода показан запрос клиента на получение данных изображения для задания, определяемого идентификатором JobId 1.

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

  <soap:Body>
    <wscn:RetrieveImageRequest>
      <wscn:JobId>1</wscn:JobId>
      <wscn:JobToken>Job9876TokenString</wscn:JobToken>
      <wscn:DocumentDescription>
        <wscn:DocumentName>Scan001.jpg</DocumentName>
      </wscn:DocumentDescription>
    </wscn:RetrieveImageRequest>
  </soap:Body>
</soap:Envelope>

См. также раздел

Описание документа

JobId

JobToken

RetrieveImageResponse

  • Last updated on