RetrieveImageRequest-Element
Das erforderliche Vorgangselement RetrieveImageRequest enthält die Anforderung des Clients zum Abrufen von Scandaten vom Gerät, nachdem ein Scanauftrag erstellt wurde.
Verbrauch
<wscn:RetrieveImageRequest>
child elements
</wscn:RetrieveImageRequest>
Attribute
Es gibt keine Attribute.
Untergeordnete Elemente
| Element |
|---|
| DocumentDescription |
| Jobid |
| JobToken |
Übergeordnete Elemente
Es gibt keine übergeordneten Elemente.
Hinweise
Der WSD-Scandienst muss das RetrieveImageRequest-Vorgangselement unterstützen.
Der Überprüfungsdienst muss die Vom Client bereitgestellten Elemente JobId und JobToken überprüfen, um sicherzustellen, dass der Auftrag gültig ist und vom Client erstellt wurde, der den Abruf anfordert. Wenn die Anforderung gültig ist, muss der Überprüfungsdienst mit einem RetrieveImageResponse-Vorgangselement antworten.
Dieser Vorgang kann alle gängigen Fehlercodes des WSD-Scandienstvorgangs zurückgeben. Weitere Informationen zum Melden von Fehlern finden Sie unter Fehlerberichterstattung für den WSD-Scandienst.
Dieser Vorgang gibt möglicherweise auch die folgenden Fehler zurück:
ClientErrorJobIdNotFoundDer Scanner kann keinen Auftrag finden, der mit dem JobId-Wert übereinstimmt, oder der JobId-Wert liegt nicht innerhalb des definierten Bereichs.
Fault-Eigenschaft Definition [Code] soap:Sender [Teilcode] wscn:ClientErrorJobIdNotFound [Grund] Die angegebene JobId wurde nicht gefunden. [Detail] JobId: Falsche JobId ClientErrorNoImagesAvailableDer Scanner verfügt nicht über weitere Bilder, die der Client abrufen kann.
Fault-Eigenschaft Definition [Code] soap:Sender [Teilcode] wscn:ClientErrorNoImagesAvailable [Grund] Auf dem Server stehen keine Images zum Abrufen zur Verfügung. [Detail] Keine ClientErrorInvalidJobTokenDer angegebene JobToken-Wert ist für die angegebene Scan-JobId ungültig.
Fault-Eigenschaft Definition [Code] soap:Sender [Teilcode] wscn:ClientErrorInvalidJobToken [Grund] Der JobToken-Parameterwert ist mit dem JobId-Parameter ungültig. [Detail] Keine ClientErrorJobCancelled
Fault-Eigenschaft Definition [Code] soap:Sender [Teilcode] wscn:ClientErrorJobCancelled [Grund] Der aktuelle Scanauftrag wurde abgebrochen. [Detail] Keine
Beispiele
Das folgende Codebeispiel zeigt eine Clientanforderung zum Abrufen von Bilddaten für den durch JobId 1 identifizierten Auftrag.
<?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>