Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
API usługi sieci Web na urządzeniach (WSDAPI) to implementacja profilu urządzeń dla usług sieci Web (DPWS) dla systemów Windows Vista i Windows Server 2008. Usługa DPWS ogranicza specyfikacje usług sieci Web, dzięki czemu klienci mogą łatwo odnajdywać urządzenia. Po odnalezieniu urządzenia klient może pobrać opis usług hostowanych na tym urządzeniu i korzystać z tych usług.
Urządzenia i usługi
Urządzenia to składniki, zwykle sprzęt, które są dołączone do sieci. Przykłady obejmują drukarki, kamery internetowe i systemy wideo.
Urządzenia mogą zawierać zero lub więcej usług . Na przykład urządzenie wideo może zawierać usługi obsługujące włączanie i wyłączanie, sterowanie odtwarzaniem, wysuwanie multimediów i przesyłanie strumieniowe wideo. Kontrola odtwarzania może obsługiwać akcje, takie jak odtwarzanie, wstrzymywanie, przewijanie i szybkie przewijanie do przodu.
Odnajdywanie urządzenia i manipulowanie nim
WSDAPI rozszerza lokalny model Plug and Play, umożliwiając klientowi odnajdywanie i uzyskiwanie dostępu do urządzenia zdalnego i skojarzonych z nim usług w sieci. Obsługuje odnajdywanie, jednokierunkową i dwukierunkową kontrolę wiadomości oraz obsługę zdarzeń.
Urządzenia DPWS ogłaszają obecność i uwidaczniają usługi (jeśli istnieją) przy użyciu unikatowego adresu i ustandaryzowanego zestawu komunikatów XML. Klienci DPWS mogą używać procesu odnajdywania, aby znaleźć urządzenie, wyliczyć jego usługi i połączyć się z tymi usługami w celu wykonania określonych akcji.
Klient WSDAPI najpierw wysyła zapytanie do urządzenia w celu uzyskania pełnych opisów jego usług, w tym typów usług (takich jak typ usługi drukarki lub typ usługi skanera). Następnie klient kontroluje urządzenie, wywołując polecenia zdefiniowane przez typ usługi (na przykład wywołując CreatePrintJob na urządzeniu z typem usługi drukarki). Opcjonalnie klient może również monitorować zmiany stanu w każdej usłudze, subskrybując zdarzenia występujące podczas wykonywania polecenia.
Aby uzyskać więcej informacji na temat wzorców komunikacji urządzeń, zobacz wzorce komunikatów dla odkrywania i wymiany metadanych .
Adresowanie logiczne i fizyczne
Adresowanie logiczne służy do unikatowego identyfikowania urządzeń niezależnie od ich adresów fizycznych. WS-Discovery zapewnia mechanizm rozpoznawania adresów logicznych na fizyczne, co umożliwia przesyłanie wiadomości od klienta do urządzenia. Przykładem jest magazyn dołączony do sieci (NAS), który nosisz. Jeśli masz laptopa i NAS, laptop powinien być w stanie rozpoznać, że NAS to to samo urządzenie, niezależnie od adresu fizycznego (adresu IP), który NAS uzyskuje podczas przechodzenia między podsieciami. Osiągnięcie tego celu wymaga, aby urządzenie miało tożsamość niezależną od uzyskiwanego adresu IP; ponieważ tradycyjne mechanizmy, takie jak DNS, nie są dostępne w normalnym scenariuszu roamingu, WS-Addressing i WS-Discovery zapewniają logiczne adresowanie i rozpoznawanie jako alternatywę ad hoc.
Gdy urządzenie jest produkowane, otrzymuje globalnie unikatowy identyfikator reprezentowany jako identyfikator URI UUID. Ten identyfikator nigdy nie zmieni się dla urządzenia. Gdy urządzenie jest włączone, zawsze ogłasza swój adres logiczny za pośrednictwem komunikatu WS-Discovery Hello. Urządzenie będzie akceptować żądania dotyczące konwersji tego adresu na adres fizyczny (zazwyczaj HTTP) za pośrednictwem komunikatów WS-Discovery Rozwiązanie lub Sondy. Po uzyskaniu prawidłowego adresu fizycznego (adresu IP) wszystkie komunikaty są wykonywane za pośrednictwem tego adresu, a WS-Discovery jest używana tylko wtedy, gdy adres ulegnie zmianie, stan urządzenia zmieni się i klienci muszą zostać powiadomieni lub urządzenie przejdzie w tryb offline.
Kompilowanie aplikacji
Interfejs WSDAPI udostępnia ogólny stos protokołu SOAP DPWS do użycia przez aplikacje klienckie i usługowe. Kod generatora usług sieciowych na urządzenia (WsdCodeGen.exe) może być użyty do konwertowania opisu usługi (WSDL) na kod pośredniczący i kod szkieletowy, które aplikacje mogą wywoływać bezpośrednio. Ten wygenerowany kod automatycznie przekształca wywołania funkcji i parametry w komunikaty PROTOKOŁU SOAP i pola XML, a następnie wywołuje interfejs WSDAPI, aby wysyłać żądania do urządzenia zdalnego lub klienta.
Odnajdywanie funkcji może być używane podczas kompilowania aplikacji WSDAPI w celu tworzenia i aktywowania wystąpień funkcji zwracanych przez rozwiązanie PnP. Te wystąpienia funkcji zawierają dane, które można wykorzystać do uzyskania bardziej szczegółowych informacji za pośrednictwem interfejsów API PnP, gdy potrzebne jest coś więcej niż tylko proste wykrywanie. Aby uzyskać więcej informacji, zobacz odkrywanie funkcji i PnP-X.
Tematy pokrewne