Elemento GetScannerElementsRequest
L'elemento GetScannerElementsRequest richiesto consente a un client di richiedere informazioni sullo scanner.
Utilizzo
<wscn:GetScannerElementsRequest>
child elements
</wscn:GetScannerElementsRequest>
Attributi
Non ci sono attributi.
Elementi figlio
| Elemento |
|---|
| RequestedElements |
Elementi padre
Non ci sono elementi padre.
Commenti
Il servizio WSD Scan deve supportare l'operazione GetScannerElementsRequest .
Un client può chiamare GetScannerElementsRequest per individuare gli elementi standard e estesi del fornitore dello schema del servizio di analisi. Le informazioni disponibili per un client includono qualsiasi parte dei dati dello scanner accessibili a livello radice del dispositivo. Queste informazioni includono la descrizione, la configurazione, lo stato, il ticket di analisi predefinito e le estensioni fornitore per il servizio di analisi.
Se il servizio di analisi elabora correttamente GetScannerElementsRequest, restituisce un'operazione GetScannerElementsResponse con le informazioni richieste. In caso contrario, il servizio di analisi deve restituire il codice di errore appropriato.
Questa operazione può restituire tutti i codici di errore comuni del servizio analisi WSD. Per altre informazioni su come segnalare gli errori, vedere Segnalazione errori del servizio di analisi WSD.
Esempio
Nell'esempio di codice seguente il client specifica un singolo valore QName (wscn:ScannerDescription) per eseguire una query per la descrizione dello 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:ScannerDescription</wscn:Name>
</wscn:RequestedElements>
</wscn:GetScannerElementsRequest>
</soap:Body>
</soap:Envelope>
L'esempio di codice seguente mostra la richiesta di un client per lo stato dello 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>
Nell'esempio di codice seguente un client specifica due valori QName. Il primo QName è wscn:ScannerConfiguration e il secondo QName non è valido.
<?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>