WSDAPI-Beispiele

Es gibt zwei WSDAPI-Beispiele, die im Windows SDK für Windows Server 2008 enthalten sind. Den Quellcode für die Beispiele finden Sie unter <Windows SDK-Installationsordner>\Samples\Web\WSDAPI. Diese Version des SDK ist im Download Center verfügbar. Die Beispiele sind nicht im Windows Vista SDK verfügbar.

Das Aktienkursbeispiel (im <Windows SDK-Installationsordner>\Samples\Web\WSDAPI\StockQuote) veranschaulicht einen Dienst mit grundlegender Messagingfunktion. Das Dateidienstbeispiel (im <Windows SDK-Installationsordner>\Samples\Web\WSDAPI\FileService) veranschaulicht einen Dienst mit erweiterter Funktionalität, z. B. asynchronem Messaging, Anlagen und Ereignissen.

Beide Beispiele umfassen die folgenden Dateitypen.

  • WSDL-Dateien, die die Dienstbeschreibungen enthalten.
  • WsdCodeGen-Konfigurationsdateien, die zum Generieren von WSDAPI-Code verwendet werden.
  • Generierte C++-Header- und Quelldateien.
  • Client- und Dienstimplementierungsdateien.
  • Visual Studio-Projekt- und Projektmappendateien.

Beide Beispiele implementieren Gerätehosts (IWSDDeviceHost), Geräteproxys (IWSDDeviceProxy) und Dienstproxys (IWSDServiceProxy). Darüber hinaus veranschaulicht das Dateidienstbeispiel die Verwendung von asynchronem Messaging (IWSDAsyncCallback, IWSDAsyncResult), Anlagen (IWSDInboundAttachment, IWSDOutboundAttachment) und Ereignisplanung.

Die Dateien FileServiceContract.vcproj und StockQuoteContract.vcproj, die in den Beispielen enthalten sind, rufen WsdCodeGen auf, um C++-Header- und Quelldateien aus der WSDL-Datei zu generieren, die in der WsdCodeGen-Konfigurationsdatei angegeben ist. Wenn die WSDL- oder WsdCodeGen-Beispielkonfigurationsdatei geändert wird und das Beispielprojekt neu erstellt wird, generiert WsdCodeGen automatisch neue Header- und Quelldateien, die die Änderungen widerspiegeln. Dies ist die bevorzugte Methode zum Erstellen von WSDAPI-Anwendungen. WsdCodeGen wird in der Regel über die Befehlszeile aufgerufen. Öffnen Sie die relevante *.vcproj-Datei, um die Beispiel-WsdCodeGen-Befehlszeilenaufrufe anzuzeigen.

WSD-Anwendungsentwicklung unter Windows