Элемент GetScannerElementsRequest
Обязательный элемент GetScannerElementsRequest позволяет клиенту запрашивать сведения о сканере.
Использование
<wscn:GetScannerElementsRequest>
child elements
</wscn:GetScannerElementsRequest>
Атрибуты
Атрибуты отсутствуют.
Дочерние элементы
Элемент |
---|
RequestedElements |
Родительские элементы
Родительские элементы отсутствуют.
Комментарии
Служба проверки WSD должна поддерживать операцию GetScannerElementsRequest .
Клиент может вызвать Метод GetScannerElementsRequest для обнаружения стандартных элементов и элементов, расширенных поставщиком в схеме службы сканирования. Сведения, доступные клиенту, включают любую часть данных сканера, доступную на корневом уровне устройства. Эти сведения включают описание, конфигурацию, состояние, запрос сканирования по умолчанию и все расширения поставщика для службы сканирования.
Если служба сканирования успешно обрабатывает GetScannerElementsRequest, она возвращает операцию GetScannerElementsResponse с запрошенными сведениями. В противном случае служба сканирования должна вернуть соответствующий код ошибки.
Эта операция может возвращать все коды распространенных ошибок операции проверки WSD. Дополнительные сведения об отчете об ошибках см. в статье Отчет об ошибках службы сканирования WSD.
Примеры
В следующем примере кода клиент указывает одно значение QName (wscn:ScannerDescription) для запроса описания сканера.
<?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>
В следующем примере кода показан запрос клиента на получение состояния сканера.
<?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>
В следующем примере кода клиент задает два значения QName. Первое значение QName — wscn:ScannerConfiguration, а второе — недопустимое.
<?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>