Elemento GetScannerElementsRequest
O elemento GetScannerElementsRequest necessário permite que um cliente solicite informações sobre o scanner.
Uso
<wscn:GetScannerElementsRequest>
child elements
</wscn:GetScannerElementsRequest>
Atributos
Não há atributos.
Elementos filho
| Elemento |
|---|
| RequestedElements |
Elementos pai
Não há elementos pai.
Comentários
O Serviço de Verificação do WSD deve dar suporte à operação GetScannerElementsRequest .
Um cliente pode chamar GetScannerElementsRequest para descobrir elementos padrão e estendidos pelo fornecedor do esquema do Serviço de Verificação. As informações disponíveis para um cliente incluem qualquer parte dos dados do scanner que esteja acessível no nível raiz do dispositivo. Essas informações incluem a descrição, configuração, status, tíquete de verificação padrão e quaisquer extensões de fornecedor para o Serviço de Verificação.
Se o Serviço de Verificação processar GetScannerElementsRequest com êxito, ele retornará uma operação GetScannerElementsResponse com as informações solicitadas. Caso contrário, o Serviço de Verificação deverá retornar o código de erro apropriado.
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.
Exemplos
No exemplo de código a seguir, o cliente especifica um único valor de QName (wscn:ScannerDescription) para consultar a descrição do verificador.
<?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/GetScannerElements
</wsa:Action>
<wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
</soap:Header>
<soap:Body>
<wscn:GetScannerElementsRequest>
<wscn:RequestedElements>
<wscn:Name>wscn:ScannerDescription</wscn:Name>
</wscn:RequestedElements>
</wscn:GetScannerElementsRequest>
</soap:Body>
</soap:Envelope>
O exemplo de código a seguir mostra a solicitação de um cliente para o status do scanner.
<?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/GetScannerElements
</wsa:Action>
<wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
</soap:Header>
<soap:Body>
<wscn:GetScannerElementsRequest>
<wscn:RequestedElements>
<wscn:Name>wscn:ScannerStatus</wscn:Name>
</wscn:RequestedElements>
</wscn:GetScannerElementsRequest>
</soap:Body>
</soap:Envelope>
No exemplo de código a seguir, um cliente especifica dois valores QName. O primeiro QName é wscn:ScannerConfiguration e o segundo QName é inválido.
<?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"
xmlns:ihv="https://www.example.com/extension"
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/GetScannerElements
</wsa:Action>
<wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
</soap:Header>
<soap:Body>
<wscn:GetScannerElementsRequest>
<wscn:RequestedElements>
<wscn:Name>wscn:ScannerConfiguration</wscn:Name>
<wscn:Name>ihv:InvalidRequestEntry</wscn:Name>
</wscn:RequestedElements>
</wscn:GetScannerElementsRequest>
</soap:Body>
</soap:Envelope>