Elemen RetrieveImageRequest

Elemen operasi RetrieveImageRequest yang diperlukan berisi permintaan klien untuk mengambil data pemindaian dari perangkat setelah pekerjaan pemindaian dibuat.

Penggunaan

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

Atribut

Tidak ada atribut.

Elemen anak

Elemen
DocumentDescription
JobId
JobToken

Elemen induk

Tidak ada elemen induk.

Keterangan

WSD Scan Service harus mendukung elemen operasi RetrieveImageRequest .

Layanan Pemindaian harus memvalidasi elemen JobId dan JobToken yang disediakan klien untuk memastikan bahwa pekerjaan tersebut valid dan dibuat oleh klien yang meminta pengambilan. Jika permintaan valid, Layanan Pemindaian harus merespons dengan elemen operasi RetrieveImageResponse .

Operasi ini dapat mengembalikan semua kode kesalahan operasi WSD Scan Service umum. Untuk informasi selengkapnya tentang cara melaporkan kesalahan, lihat Pelaporan Kesalahan Operasi Layanan Pemindaian WSD.

Operasi ini mungkin juga mengembalikan kesalahan berikut:

• ClientErrorJobIdNotFoundPemindai tidak dapat menemukan pekerjaan yang cocok dengan nilai JobId atau nilai JobId tidak berada dalam rentang yang ditentukan.

  Properti kesalahan	Definisi
  [Kode]	soap:Pengirim
  [Subkode]	wscn:ClientErrorJobIdNotFound
  [Alasan]	JobId yang ditentukan tidak ditemukan.
  [Detail]	JobId: JobId salah

• ClientErrorNoImagesAvailablePemindai tidak memiliki gambar lagi yang tersedia untuk diambil klien.

  Properti kesalahan	Definisi
  [Kode]	soap:Pengirim
  [Subkode]	wscn:ClientErrorNoImagesAvailable
  [Alasan]	Server tidak memiliki citra yang tersedia untuk diperoleh.
  [Detail]	Tidak ada

• ClientErrorInvalidJobTokenNilai JobToken yang disediakan tidak valid untuk jobId pemindaian yang ditentukan.

  Properti kesalahan	Definisi
  [Kode]	soap:Pengirim
  [Subkode]	wscn:ClientErrorInvalidJobToken
  [Alasan]	Nilai parameter JobToken tidak valid dengan parameter JobId.
  [Detail]	Tidak ada

• ClientErrorJobCancelled

  Properti kesalahan	Definisi
  [Kode]	soap:Pengirim
  [Subkode]	wscn:ClientErrorJobCancelled
  [Alasan]	Tugas pemindaian saat ini telah dibatalkan.
  [Detail]	Tidak ada

Contoh

Contoh kode berikut menunjukkan permintaan klien untuk mengambil data gambar untuk pekerjaan yang diidentifikasi oleh 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>

Lihat juga

DocumentDescription

JobId

JobToken

RetrieveImageResponse