RetrieveImageRequest 요소
필수 RetrieveImageRequest 작업 요소에는 검색 작업이 생성된 후 디바이스에서 검사 데이터를 검색하라는 클라이언트의 요청이 포함됩니다.
사용량
<wscn:RetrieveImageRequest>
child elements
</wscn:RetrieveImageRequest>
특성
특성이 없습니다.
자식 요소
| 요소 |
|---|
| DocumentDescription |
| JobId |
| JobToken |
부모 요소
부모 요소가 없습니다.
설명
WSD Scan Service는 RetrieveImageRequest 작업 요소를 지원해야 합니다.
Scan Service는 클라이언트가 제공하는 JobId 및 JobToken 요소의 유효성을 검사하여 작업이 유효하고 검색을 요청하는 클라이언트에 의해 생성되었는지 확인해야 합니다. 요청이 유효한 경우 Scan Service는 RetrieveImageResponse 작업 요소로 응답해야 합니다.
이 작업은 일반적인 WSD Scan Service 작업 오류 코드를 모두 반환할 수 있습니다. 오류를 보고하는 방법에 대한 자세한 내용은 WSD 스캔 서비스 작업 오류 보고를 참조하세요.
이 작업은 다음 오류를 반환할 수도 있습니다.
ClientErrorJobIdNotFound스캐너가 JobId 값과 일치하는 작업을 찾을 수 없거나 JobId 값이 정의된 범위 내에 있지 않습니다.
Fault 속성 정의 [코드] soap:Sender [하위 코드] wscn:ClientErrorJobIdNotFound [이유] 지정된 JobId를 찾을 수 없습니다. [세부 정보] 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>