GetScannerElementsRequest-Element
Das erforderliche GetScannerElementsRequest-Element ermöglicht es einem Client, Informationen zum Scanner anzufordern.
Verbrauch
<wscn:GetScannerElementsRequest>
child elements
</wscn:GetScannerElementsRequest>
Attribute
Es gibt keine Attribute.
Untergeordnete Elemente
| Element |
|---|
| RequestedElements |
Übergeordnete Elemente
Es gibt keine übergeordneten Elemente.
Hinweise
Der WSD-Scandienst muss den Vorgang GetScannerElementsRequest unterstützen.
Ein Client kann GetScannerElementsRequest aufrufen, um standard- und anbieterweite Elemente des Schemas des Scandiensts zu ermitteln. Die Informationen, die einem Client zur Verfügung stehen, umfassen alle Teile der Scannerdaten, auf die auf der Gerätestammebene zugegriffen werden kann. Diese Informationen umfassen die Beschreibung, Konfiguration, status, das Standardscanticket und alle Anbietererweiterungen für den Scandienst.
Wenn der Überprüfungsdienst GetScannerElementsRequest erfolgreich verarbeitet, gibt er einen GetScannerElementsResponse-Vorgang mit den angeforderten Informationen zurück. Andernfalls sollte der Überprüfungsdienst den entsprechenden Fehlercode zurückgeben.
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.
Beispiele
Im folgenden Codebeispiel gibt der Client einen einzelnen QName-Wert (wscn:ScannerDescription) an, um die Beschreibung des Scanners abzufragen.
<?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>
Das folgende Codebeispiel zeigt die Anforderung eines Clients für die status des Scanners.
<?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>
Im folgenden Codebeispiel gibt ein Client zwei QName-Werte an. Der erste QName ist wscn:ScannerConfiguration, und der zweite QName ist ungültig.
<?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>