Élément GetScannerElementsRequest

Article
02/07/2024

L’élément GetScannerElementsRequest requis permet à un client de demander des informations sur le scanneur.

Utilisation

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

Attributs

Il n’y a pas d’attributs.

Éléments enfants

Élément
RequestedElements

Éléments parents

Il n’y a pas d’éléments parents.

Remarques

Le service d’analyse WSD doit prendre en charge l’opération GetScannerElementsRequest .

Un client peut appeler GetScannerElementsRequest pour découvrir les éléments standard et étendus au fournisseur du schéma du service d’analyse. Les informations disponibles pour un client incluent toute partie des données du scanneur accessibles au niveau de la racine de l’appareil. Ces informations incluent la description, la configuration, les status, le ticket d’analyse par défaut et toutes les extensions de fournisseur pour le service d’analyse.

Si le service d’analyse traite correctement GetScannerElementsRequest, il retourne une opération GetScannerElementsResponse avec les informations demandées. Sinon, le service d’analyse doit retourner le code d’erreur approprié.

Cette opération peut retourner tous les codes d’erreur courants du service d’analyse WSD. Pour plus d’informations sur la façon de signaler des erreurs, consultez Rapport d’erreurs des opérations du service d’analyse WSD.

Exemples

Dans l’exemple de code suivant, le client spécifie une seule valeur QName (wscn :ScannerDescription) pour interroger la description du scanneur.

<?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’exemple de code suivant montre la demande d’un client pour le status du scanneur.

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

Dans l’exemple de code suivant, un client spécifie deux valeurs QName. Le premier QName est wscn :ScannerConfiguration, et le second QName n’est pas valide.

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

Voir aussi

GetScannerElementsResponse

RequestedElements

Partager via