Элемент RetrieveImageResponse

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

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

<wscn:RetrieveImageResponse>
  child elements
</wscn:RetrieveImageResponse>

Атрибуты

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

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

Элемент
ScanData

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

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

Комментарии

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

Служба сканирования возвращает данные сканирования в виде двоичного вложения с пакетом RetrieveImageResponse . Ответ должен быть упакована в виде MIME Multipart-Related типа контента и использовать механизм оптимизации передачи сообщений SOAP [MTOM] для эффективной отправки двоичных данных изображения.

Количество изображений, возвращаемых службой сканирования в результирующем файле, зависит от сочетания элемента ImagesToTransferэлемента ScanTicket и элемента Format файла изображения следующим образом:

• Если Формат задает один формат изображения, возвращаемый файл всегда будет содержать одно изображение.
• Если параметр Format задает многостраничный формат, возвращаемый файл будет содержать столько изображений, сколько источник входных данных может сканировать до значения ImagesToTransfer.

Если Формат указывает один формат изображения и значение ImagesToTransfer равно 0 или больше 1, клиент будет отправлять повторяющиеся элементы операции RetrieveImageRequest до тех пор, пока служба сканирования не ответит ошибкой ClientErrorNoImagesAvailable или пока не будет выполнено значение ImagesToTransfer .

Служба сканирования должна прервать задание с помощью параметра JobStateReasonImageTransferError , если во время передачи данных изображения возникает ошибка обмена данными.

Примеры

В следующем примере кода показано, как служба сканирования WSD отправляет данные изображения клиенту.

mime-version: 1.0
Content-Type: multipart/related;
    type=application/xop+xml;
    boundary=4aa7d814-adc1-47a2-8e1c-07585b9892a4;
    start="<14629f74-2047-436c-8046-5cac76d280fc@uuid>";
    startinfo=application/soap+xml


--4aa7d814-adc1-47a2-8e1c-07585b9892a4
Content-Type: application/xop+xml; type="application/soap+xml"
                                   charset=UTF-8
Content-Transfer-Encoding: binary
Content-ID: <14629f74-2047-436c-8046-5cac76d280fc@uuid>

<?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:xop="https://www.w3.org/2003/12/xop/include"
  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>https://schemas.xmlsoap.org/ws/2003/03/addressing/role/anonymous</wsa:To>
    <wsa:Action>
      https://schemas.microsoft.com/windows/2006/01/wdp/scan/RetrieveImage
    </wsa:Action>
    <wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
    <wsa:RelatesTo>uuid:MsgIdOfTheRetrieveImageRequest</wsa:RelatesTo>
  </soap:Header>

  <soap:Body>
    <wscn:RetrieveImageResponse>
      <wscn:ScanData>
        <xop:Include href="cid:1c696bd7-005a-48d9-9ee9-9adca11f8892@uuid" />
      </wscn:ScanData>
    </wscn:RetrieveImageResponse>
  </soap:Body>
</soap:Envelope>

--4aa7d814-adc1-47a2-8e1c-07585b9892a4

Content-Type: image/jpeg;
Content-Transfer-Encoding: binary
Content-ID: <1c696bd7-005a-48d9-9ee9-9adca11f8892@uuid >

Binary Scan Data
--4aa7d814-adc1-47a2-8e1c-07585b9892a4--

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

Формат

ImagesToTransfer

JobStateReason

RetrieveImageRequest

ScanData

ScanTicket