RetrieveImageResponse 요소
필요한 RetrieveImageResponse 작업 요소는 검사 데이터를 클라이언트에 반환합니다.
사용량
<wscn:RetrieveImageResponse>
child elements
</wscn:RetrieveImageResponse>
특성
특성이 없습니다.
자식 요소
| 요소 |
|---|
| ScanData |
부모 요소
부모 요소가 없습니다.
설명
WSD Scan Service는 RetrieveImageResponse 작업 요소를 지원해야 합니다. Scan Service는 클라이언트가 RetrieveImageRequest 요소를 성공적으로 보낼 때 이 요소를 보냅니다.
Scan Service는 검색 데이터를 RetrieveImageResponse 패킷을 사용하여 이진 첨부 파일로 반환합니다. 응답은 MIME Multipart-Related 콘텐츠 형식으로 패키지되어야 하며 SOAP 메시지 전송 최적화 메커니즘[MTOM]을 사용하여 이진 이미지 데이터를 효율적으로 보내야 합니다.
결과 파일에서 Scan Service가 반환하는 이미지 수는 다음과 같이 ScanTicket의 ImagesToTransfer 요소와 이미지 파일 Format 요소의 조합에 따라 달라집니다.
- Format이 단일 이미지 형식을 지정하는 경우 반환된 파일에는 항상 단일 이미지가 포함됩니다.
- Format이 다중 페이지 형식을 지정하는 경우 반환된 파일에는 입력 원본이 ImagesToTransfer 값까지 검색할 수 있는 만큼의 이미지가 포함됩니다.
Format이 단일 이미지 형식을 지정하고 ImagesToTransfer 값이 0 이상인 경우 Scan Service가 ClientErrorNoImagesAvailable 오류로 응답하거나 ImagesToTransfer 값이 충족될 때까지 클라이언트는 반복된 RetrieveImageRequest 작업 요소를 보냅니다.
이미지 데이터를 전송하는 동안 통신 오류가 있는 경우 Scan Service는 ImageTransferError의 JobStateReason으로 작업을 중단해야 합니다.
예제
다음 코드 예제에서는 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--