CreateScanJobResponse 元素
所需的 CreateScanJobResponse 元素包含 WSD 扫描服务对客户端扫描请求的响应。
使用情况
<wscn:CreateScanJobResponse>
child elements
</wscn:CreateScanJobResponse>
属性
没有属性。
子元素
| 元素 |
|---|
| DocumentFinalParameters |
| ImageInformation |
| JobId |
| JobToken |
父元素
没有父元素。
注解
WSD 扫描服务必须支持 CreateScanJobResponse 操作元素。
WSD 扫描服务将 CreateScanJobResponse 操作元素发送到客户端，以响应客户端的 CreateScanJobRequest。
如果客户端已发出有效的扫描请求，则 WSD 扫描服务必须返回以下信息：
用于标识作业的唯一 JobId 。 扫描程序在定义的范围内以实现定义的方式生成 JobId 。 扫描服务不得重复使用最近分配的值，以便客户端不会将作业与较旧的作业混淆。
JobToken 中的唯一标识符。 JobToken 与 JobId 配对，以唯一表示扫描作业。 JobToken 将传递到 RetrieveImageRequest 操作元素中的扫描服务，使扫描设备能够验证扫描请求者是否确实创建了扫描作业。
ImageInformation，其中包含有关使用当前正在验证的 ScanTicket 进行的扫描所产生的图像数据的信息。
DocumentFinalParameters，其中包含扫描服务用于此扫描作业的实际 DocumentParameters 元素。
客户端必须通过发送一个或多个 RetrieveImageRequest 操作元素从扫描服务检索实际图像数据。 扫描服务响应客户端的 CreateScanJobRequest 后，客户端有 60 秒的时间发送 RetrieveImageRequest 操作元素。 如果扫描服务在这段时间内未收到 RetrieveImageRequest ，则它应中止作业，而 JobStateReason 为 JobTimedOut。 如果作业包含多个文档，则每次连续 的 RetrieveImageRequest/Response 操作之间都会应用此超时。
示例
以下代码示例演示了对 CreateScanJobRequest 的 WSD 扫描服务响应。
<?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>
https://schemas.xmlsoap.org/ws/2003/03/addressing/role/anonymous
</wsa:To>
<wsa:Action>
https://schemas.microsoft.com/windows/2006/01/wdp/scan/CreateScanJob
</wsa:Action>
<wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
<wsa:RelatesTo>uuid:MsgIdOfTheCreateScanJobRequest</wsa:RelatesTo>
</soap:Header>
<soap:Body>
<wscn:CreateScanJobResponse>
<wscn:JobId>1</wscn:JobId>
<wscn:JobToken>Job9876TokenString</wscn:JobToken>
<wscn:ImageInformation>
<wscn:MediaFrontImageInfo>
<wscn:PixelsPerLine>900</wscn:PixelsPerLine>
<wscn:NumberOfLines>1500</wscn:NumberOfLines>
<wscn:BytesPerLine>113</wscn:BytesPerLine>
</wscn:MediaFrontImageInfo>
</wscn:ImageInformation>
<wscn:DocumentFinalParamters>
<wscn:Format>jfif</wscn:Format>
<wscn:CompressionQualityFactor>45</wscn:CompressionQualityFactor>
<wscn:ImagesToTransfer>0</wscn:ImagesToTransfer>
<wscn:InputSource>Platen</wscn:InputSource>
<wscn:ContentType>Auto</wscn:ContentType>
<wscn:InputSize>
<wscn:InputMediaSize>
<wscn:Width wscn:Override="true">8500</wscn:Width>
<wscn:Height wscn:Override="true">11000</wscn:Height>
</wscn:InputMediaSize>
</wscn:InputSize>
<wscn:Exposure>
<wscn:ExposureSettings>
<wscn:Contrast wscn:UsedDefault="true">0</wscn:Contrast>
<wscn:Brightness wscn:UsedDefault="true">0</wscn:Brightness>
<wscn:Sharpness wscn:UsedDefault="true">0</wscn:Sharpness>
</wscn:ExposureSettings>
</wscn:Exposure>
<wscn:Scaling>
<wscn:ScalingWidth>125</wscn:ScalingWidth>
<wscn:ScalingHeight>125</wscn:ScalingHeight>
</wscn:Scaling>
<wscn:Rotation wscn:UsedDefault="true">0</wscn:Rotation>
<wscn:MediaSides>
<wscn:MediaFront>
<wscn:ScanRegion>
<wscn:ScanRegionXOffset wscn:UsedDefault="true">
0
</wscn:ScanRegionXOffset>
<wscn:ScanRegionYOffset wscn:UsedDefault="true">
0
</wscn:ScanRegionYOffset>
<wscn:ScanRegionWidth wscn:UsedDefault="true">
8500
</wscn:ScanRegionWidth>
<wscn:ScanRegionHeight wscn:UsedDefault="true">
11000
</wscn:ScanRegionHeight>
</wscn:ScanRegion>
<wscn:ColorProcessing wscn:UsedDefault="true">
RGB24
</wscn:ColorProcessing>
<wscn:Resolution>
<wscn:Width>300</wscn:Width>
<wscn:Height>300</wscn:Height>
</wscn:Resolution>
</wscn:MediaFront>
</wscn:MediaSides>
</wscn:DocumentFinalParamters>
</wscn:CreateScanJobResponse>
</soap:Body>
</soap:Envelope>