Elemento GetScannerElementsRequest
El elemento GetScannerElementsRequest necesario permite a un cliente solicitar información sobre el analizador.
Uso
<wscn:GetScannerElementsRequest>
child elements
</wscn:GetScannerElementsRequest>
Atributos
No hay atributos.
Elementos secundarios
| Elemento |
|---|
| RequestedElements |
Elementos primarios
No hay elementos primarios.
Comentarios
El servicio de examen de WSD debe admitir la operación GetScannerElementsRequest .
Un cliente puede llamar a GetScannerElementsRequest para detectar elementos estándar y extendidos por el proveedor del esquema del servicio Scan. La información que está disponible para un cliente incluye cualquier parte de los datos del escáner a los que se pueda acceder en el nivel raíz del dispositivo. Esta información incluye la descripción, la configuración, el estado, el vale de examen predeterminado y las extensiones de proveedor para el servicio scan.
Si el servicio Scan procesa correctamente GetScannerElementsRequest, devuelve una operación GetScannerElementsResponse con la información solicitada. De lo contrario, el servicio scan debe devolver el código de error adecuado.
Esta operación puede devolver todos los códigos de error comunes de operación del servicio de examen de WSD. Para obtener más información sobre cómo notificar errores, vea Informe de errores de la operación del servicio de examen de WSD.
Ejemplos
En el ejemplo de código siguiente, el cliente especifica un único valor QName (wscn:ScannerDescription) para consultar la descripción del analizador.
<?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>
En el ejemplo de código siguiente se muestra la solicitud de un cliente para el estado del analizador.
<?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>
En el ejemplo de código siguiente, un cliente especifica dos valores QName. El primer QName es wscn:ScannerConfiguration y el segundo QName no es vá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>