ScanAvailableEvent-Element

Das erforderliche ScanAvailableEvent-Element informiert einen Client darüber, dass ein Scangerät, für das der Client abonniert ist, bereit ist, einen Auftrag zu scannen.

Verbrauch

<wscn:ScanAvailableEvent>
  child elements
</wscn:ScanAvailableEvent>

Attribute

Es gibt keine Attribute.

Untergeordnete Elemente

Übergeordnete Elemente

Es gibt keine übergeordneten Elemente.

Hinweise

Der WSD-Überprüfungsdienst sendet ein ScanAvailableEvent-Element an einen registrierten Client, wenn ein Benutzer ein Scanziel ausgewählt und eine Überprüfung auf dem Scangerät initiiert hat.

Ein Client muss ein Abonnement mit dem WSD-Überprüfungsdienst erstellen, um ScanAvailableEvent-Ereignisse zu empfangen. Der Client erstellt ein Abonnement, indem er eine Anforderungsnachricht über das Anforderungsvorgangselement wse:Subscribe> an den< Scandienst sendet.

Die Abonnementanforderung enthält mindestens ein Ziel im ScanDestinations-Erweiterungselement . Der Überprüfungsdienst verwendet diese Ziele, um jedes Mal, wenn er eine ScanAvailableEvent-Benachrichtigung sendet, auf einen einzelnen Client zu filtern. Dieser Filter verhindert, dass der Überprüfungsdienst jeden Client benachrichtigt, wenn ein Benutzer die Scanschaltfläche drückt. Die Erweiterungselemente werden im WSD Scan Service-Namespace definiert und dann dem Anforderungstext wse<:Subscribe> hinzugefügt.

Wenn der WSD-Überprüfungsdienst die Anforderung des Clients zum Erstellen eines Abonnements akzeptiert, muss der Dienst mit einem <wse:SubscribeResponse-Antwortvorgangselement> antworten. Die Abonnentenantwort enthält eine oder mehrere Zielantworten im DestinationResponses-Erweiterungselement , das das Abonnement mit dem Scangerät verbindet, das es akzeptiert hat.

Die <Elemente wse:Subscribe> und <wse:SubscribeResponse> werden in der Spezifikation beschrieben.

Beispiele

Das folgende Codebeispiel zeigt, wie ein Client scanAvailableEvent-Ereignisse vom WSD-Scandienst abonniert.

<soap:Envelope
    xmlns:soap="https://www.w3.org/2003/05/soap-envelope"
    xmlns:wsa="https://schemas.xmlsoap.org/ws/2004/08/addressing"
    xmlns:wse="https://schemas.xmlsoap.org/ws/2004/08/eventing"
    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.xmlsoap.org/ws/2004/08/eventing/Subscribe
      </wsa:Action>
      <wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
      <wsa:ReplyTo>
        <wsa:Address>https://www.example.com/MyEventSink</wsa:Address>
      </wsa:ReplyTo>
  </soap:Header>
  <soap:Body>
    <wse:Subscribe>
      <wse:Delivery>
        <wse:NotifyTo>
          <wsa:Address>
            https://www.example.com/MyEventSink/OnScanAvailableForMe
          </wsa:Address>
        </wse:NotifyTo>
      </wse:Delivery>
      <wse:Expires>P0Y0M0DT30H0M0S</wse:Expires>
      <wse:Filter xmlns:wscn="https://schemas.microsoft.com/windows/2006/01/wdp/scan">
        ScanAvailableEvent
      </wse:Filter>
      <wscn:ScanDestinations>
        <wscn:ScanDestination>
          <wscn:ClientDisplayString>Den Computer</wscn:ClientDisplayString>
          <wscn:ClientContext>App1ScanID2345</wscn:ClientContext>
        </wscn:ScanDestination>
      </wscn:ScanDestinations>
    </wse:Subscribe>
    </soap:Body
</soap:Envelope>

Das folgende Codebeispiel zeigt die Antwort des WSD-Scandiensts auf die Abonnementanforderung eines Clients.

<soap:Envelope
    xmlns:soap="https://www.w3.org/2003/05/soap-envelope"
    xmlns:wsa="https://schemas.xmlsoap.org/ws/2004/08/addressing"
    xmlns:wse="https://schemas.xmlsoap.org/ws/2004/08/eventing"
    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>https://schemas.xmlsoap.org/ws/2003/03/addressing/role/anonymous</wsa:To>
    <wsa:Action>
      https://schemas.xmlsoap.org/ws/2004/08/eventing/SubscribeResponse
    </wsa:Action>
    <wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
    <wsa:RelatesTo>uuid:MsgIdOfTheSubscribe</wsa:RelatesTo>
  </soap:Header>
  <soap:Body>
    <wse:SubscribeResponse>
        <wse:SubscriptionManager>
             <!-- Elements removed for clarity  -->
        </wse:SubscriptionManager>
        <wse:Expires>P0Y0M0DT30H0M0S</wse:Expires>
        <wscn:DestinationResponses>
          <wscn:DestinationResponse>
            <wscn:ClientContext>App1ScanID2345</wscn:ClientContext>
            <wscn:DestinationToken>Client3478</wscn:DestinationToken>
          </wscn:DestinationResponse>
        </wscn:DestinationResponses>
      </wse:SubscribeResponse>
    </soap:Body
</soap:Envelope>

Das folgende Codebeispiel zeigt, wie der WSD-Überprüfungsdienst ein ScanAvailableEvent an einen Client sendet.

<soap:Envelope
  xmlns:soap="https://www.w3.org/2003/05/soap-envelope"
  xmlns:wsa="https://schemas.xmlsoap.org/ws/2004/08/addressing"
  xmlns:wse="https://schemas.xmlsoap.org/ws/2004/08/eventing"
  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>AddressofEventSink</wsa:To>
    <wsa:Action>
      https://schemas.microsoft.com/windows/2006/01/wdp/scan/ScanAvailableEvent
    </wsa:Action>
    <wsa:MessageID>uuid:UniqueMsgId</wsa:MessageID>
  </soap:Header>

  <soap:Body>
    <wscn:ScanAvailableEvent>
      <wscn:ClientContext>App1ScanID2345</wscn:ClientContext>
      <wscn:ScanIdentifier>AnyUniqueIdentifierSuchAsAGUID</wscn:ScanIdentifier>
    </wscn:ScanAvailableEvent>
  </soap:Body
</soap:Envelope>

Weitere Informationen

ClientContext

DestinationResponses

ScanDestinations

ScanIdentifier