Informationen zu Webdiensten auf Geräten
Web Service on Devices API (WSDAPI) ist eine Implementierung des Geräteprofils für Webdienste (DPWS) für Windows Vista und Windows Server 2008. Der DPWS schränkt Die Webdienstspezifikationen ein, damit Clients Geräte problemlos ermitteln können. Sobald ein Gerät erkannt wurde, kann ein Client eine Beschreibung der dienste abrufen, die auf diesem Gerät gehostet werden, und diese Dienste verwenden.
Geräte und Dienste
Geräte sind Komponenten, in der Regel Hardware, die an das Netzwerk angefügt sind. Beispiele hierfür sind Drucker, Webkameras und Videosysteme.
Geräte können 0 oder mehr Dienste enthalten. Ein Videogerät kann beispielsweise Dienste umfassen, die ein- und ausschalten, die Wiedergabesteuerung, Medienauswurf und Videostreaming unterstützen. Die Wiedergabesteuerung unterstützt möglicherweise Aktionen wie "Wiedergeben", "Anhalten", "Zurückspulen" und "Schnelles Vorwärts".
Ermitteln und Bearbeiten eines Geräts
WSDAPI erweitert das lokale Plug & Play-Modell, indem es einem Client ermöglicht, ein Remotegerät und die zugehörigen Dienste über ein Netzwerk zu ermitteln und darauf zuzugreifen. Es unterstützt Ermittlung, unidirektionales und bidirektionales Steuerungsmessaging sowie Ereigniserstellung.
DPWS-Geräte kündigen ihre Anwesenheit an und machen Dienste (falls vorhanden) mit einer eindeutigen Adresse und einem standardisierten Satz von XML-Nachrichten verfügbar. DPWS-Clients können den Ermittlungsprozess verwenden, um das Gerät zu finden, seine Dienste aufzulisten und eine Verbindung mit diesen Diensten herzustellen, um bestimmte Aktionen auszuführen.
Ein WSDAPI-Client fragt zunächst das Gerät nach vollständigen Beschreibungen seiner Dienste ab, einschließlich der Diensttypen (z. B. druckerdiensttyp oder Scannerdiensttyp). Der Client steuert dann das Gerät, indem er Befehle aufruft, die durch einen Diensttyp definiert sind (z. B. durch Aufrufen von CreatePrintJob auf einem Gerät mit einem Druckerdiensttyp). Optional kann der Client auch Zustandsänderungen in jedem Dienst überwachen, indem er Ereignisse abonniert, die während der Befehlsausführung auftreten.
Weitere Informationen zu Gerätemessagingmustern finden Sie unter Erkennungs- und Metadatenaustausch-Nachrichtenmuster.
Logische und physische Adressierung
Die logische Adressierung wird verwendet, um Geräte unabhängig von ihren physischen Adressen eindeutig zu identifizieren. WS-Discovery bietet einen Mechanismus zum Auflösen logischer Adressen in physische Adressen, sodass Client-zu-Gerät-Messaging durchgeführt werden kann. Ein Beispiel ist Network Attached Storage (NAS), den Sie mit sich führen. Wenn Sie über einen Laptop und ein NAS verfügen, sollte Ihr Laptop erkennen können, dass es sich um dasselbe Gerät handelt, unabhängig von der physischen Adresse (IP-Adresse), die das NAS beim Wechsel zwischen Subnetzen erhält. Dies erfordert, dass das Gerät über eine Identität verfügt, die unabhängig von der IP-Adresse ist, die es erhält. da herkömmliche Mechanismen wie DNS in einem normalen Roamingszenario nicht verfügbar sind, bieten WS-Addressing und WS-Discovery logische Adressierung und Auflösung als Ad-hoc-Alternative.
Wenn ein Gerät hergestellt wird, erhält es einen global eindeutigen Bezeichner, der als UUID-URI dargestellt wird. Dieser Bezeichner ändert sich für das Gerät nie. Wenn das Gerät eingeschaltet ist, gibt es seine logische Adresse immer über eine WS-Discovery Hello-Nachricht an und akzeptiert Anforderungen zur Konvertierung in eine physische Adresse (in der Regel HTTP) über WS-Discovery Resolve - oder Testnachrichten . Sobald eine gültige physische Adresse (IP-Adresse) abgerufen wurde, erfolgt das gesamte Messaging über diese Adresse, und WS-Discovery wird nur verwendet, wenn sich die Adresse ändert, das Gerät den Zustand ändert und die Clients benachrichtigt werden müssen oder das Gerät offline geht.
Erstellen von Anwendungen
WSDAPI stellt einen generischen DPWS-SOAP-Stapel zur Verwendung durch Client- und Dienstanwendungen bereit. Der Web Services on Devices Code Generator (WsdCodeGen.exe) kann verwendet werden, um eine Dienstbeschreibung (Service Description, WSDL) in Proxy- und Stubcode zu konvertieren, den Anwendungen direkt aufrufen können. Dieser generierte Code transformiert Automatisch Funktionsaufrufe und Parameter in SOAP-Nachrichten und XML-Felder und ruft dann in WSDAPI auf, um Anforderungen an das Remotegerät oder Den Remoteclient auszugeben.
Die Funktionsermittlung kann beim Erstellen von WSDAPI-Anwendungen verwendet werden, um von PnP zurückgegebene Funktionsinstanzen zu erstellen und zu aktivieren. Diese Funktionsinstanzen enthalten Daten, die verwendet werden können, um mehr Informationen über die PnP-APIs zu erhalten, wenn mehr als nur eine einfache Ermittlung erforderlich ist. Weitere Informationen finden Sie unter Funktionsermittlung und PnP-X.
Zugehörige Themen