Elemento RetrieveImageRequest
O elemento de operação RetrieveImageRequest necessário contém a solicitação do cliente para recuperar dados de verificação do dispositivo após a criação de um trabalho de verificação.
Uso
<wscn:RetrieveImageRequest>
child elements
</wscn:RetrieveImageRequest>
Atributos
Não há atributos.
Elementos filho
| Elemento |
|---|
| DocumentDescription |
| JobId |
| JobToken |
Elementos pai
Não há elementos pai.
Comentários
O Serviço de Verificação do WSD deve dar suporte ao elemento de operação RetrieveImageRequest .
O Serviço de Verificação deve validar os elementos JobId e JobToken que o cliente fornece para garantir que o trabalho seja válido e foi criado pelo cliente que está solicitando a recuperação. Se a solicitação for válida, o Serviço de Verificação deverá responder com um elemento de operação RetrieveImageResponse .
Essa operação pode retornar todos os códigos de erro comuns de operação do Serviço de Verificação do WSD. Para obter mais informações sobre como relatar erros, consulte Relatório de erros de operação do serviço de verificação do WSD.
Essa operação também pode retornar os seguintes erros:
ClientErrorJobIdNotFoundO verificador não pode encontrar um trabalho que corresponda ao valor JobId ou que o valor jobId não esteja dentro do intervalo definido.
Propriedade Fault Definição [Código] soap:Sender [Subcódigo] wscn:ClientErrorJobIdNotFound [Motivo] O JobId especificado não foi encontrado. [Detalhe] JobId: JobId incorreto ClientErrorNoImagesAvailableO verificador não tem mais imagens disponíveis para o cliente recuperar.
Propriedade Fault Definição [Código] soap:Sender [Subcódigo] wscn:ClientErrorNoImagesAvailable [Motivo] O servidor não tem imagens disponíveis para aquisição. [Detalhe] Nenhum ClientErrorInvalidJobTokenO valor de JobToken fornecido não é válido para o JobId de verificação especificado.
Propriedade Fault Definição [Código] soap:Sender [Subcódigo] wscn:ClientErrorInvalidJobToken [Motivo] O valor do parâmetro JobToken não é válido com o parâmetro JobId. [Detalhe] Nenhum ClientErrorJobCancelled
Propriedade Fault Definição [Código] soap:Sender [Subcódigo] wscn:ClientErrorJobCancelled [Motivo] O trabalho de verificação atual foi cancelado. [Detalhe] Nenhum
Exemplos
O exemplo de código a seguir mostra uma solicitação de cliente para recuperar dados de imagem para o trabalho identificado por 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>