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，而第二個 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