Elemen RetrieveImageResponse

Elemen operasi RetrieveImageResponse yang diperlukan mengembalikan data pemindaian ke klien.

Penggunaan

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

Atribut

Tidak ada atribut.

Elemen anak

Elemen
ScanData

Elemen induk

Tidak ada elemen induk.

Keterangan

WSD Scan Service harus mendukung elemen operasi RetrieveImageResponse . Scan Service mengirimkan elemen ini ketika klien berhasil mengirim elemen RetrieveImageRequest .

Layanan Pemindaian mengembalikan data pemindaian sebagai lampiran biner dengan paket RetrieveImageResponse . Respons harus dikemas sebagai MIME Multipart-Related jenis konten dan memanfaatkan Mekanisme Pengoptimalan Transmisi Pesan SOAP [MTOM] untuk mengirim data gambar biner secara efisien.

Jumlah gambar yang dikembalikan Scan Service dalam file yang dihasilkan tergantung pada kombinasi elemen ImagesToTransfer dari ScanTicket dan elemen Format file gambar sebagai berikut:

  • Jika Format menentukan format gambar tunggal, file yang dikembalikan akan selalu berisi satu gambar.
  • Jika Format menentukan format multi-halaman, file yang dikembalikan akan berisi gambar sebanyak sumber input yang dapat memindai hingga nilai ImagesToTransfer.

Jika Format menentukan format gambar tunggal dan nilai ImagesToTransfer adalah 0 atau lebih besar dari 1, klien akan mengirim elemen operasi RetrieveImageRequest berulang hingga Layanan Pemindaian membalas dengan kesalahan ClientErrorNoImagesAvailable atau sampai nilai ImagesToTransfer terpenuhi.

Layanan Pemindaian harus membatalkan pekerjaan dengan JobStateReason dari ImageTransferError jika ada kesalahan komunikasi selama transfer data gambar.

Contoh

Contoh kode berikut menunjukkan bagaimana WSD Scan Service mengirim data gambar ke klien.

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

Lihat juga

Format

ImagesToTransfer

JobStateReason

RetrieveImageRequest

ScanData

ScanTicket

  • Last updated on