GetScannerElementsRequest 요소

필요한 GetScannerElementsRequest 요소를 사용하면 클라이언트가 스캐너에 대한 정보를 요청할 수 있습니다.

사용량

<wscn:GetScannerElementsRequest>
  child elements
</wscn:GetScannerElementsRequest>

특성

특성이 없습니다.

자식 요소

요소
RequestedElements

부모 요소

부모 요소가 없습니다.

설명

WSD 스캔 서비스는 GetScannerElementsRequest 작업을 지원해야 합니다.

클라이언트는 GetScannerElementsRequest 를 호출하여 Scan Service 스키마의 표준 및 공급업체 확장 요소를 검색할 수 있습니다. 클라이언트에서 사용할 수 있는 정보에는 디바이스 루트 수준에서 액세스할 수 있는 스캐너 데이터의 일부가 포함됩니다. 이 정보에는 설명, 구성, 상태, 기본 검사 티켓 및 Scan Service에 대한 모든 공급업체 확장이 포함됩니다.

Scan Service가 GetScannerElementsRequest를 성공적으로 처리하면 요청된 정보가 포함된 GetScannerElementsResponse 작업이 반환됩니다. 그렇지 않으면 Scan Service에서 적절한 오류 코드를 반환해야 합니다.

이 작업은 일반적인 WSD Scan Service 작업 오류 코드를 모두 반환할 수 있습니다. 오류를 보고하는 방법에 대한 자세한 내용은 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이고 두 번째 QName은 잘못되었습니다.

<?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>

추가 정보

GetScannerElementsResponse

RequestedElements