WSDAPI 示例

Windows Server 2008 的 Windows SDK 随附了两个 WSDAPI 示例。 可在 Windows SDK 安装文件夹 <\Samples\Web\WSDAPI> 中找到这些示例的源代码。 可通过下载中心获取此版本的 SDK。 Windows Vista SDK 不提供这些示例。

股票报价示例(位于 <Windows SDK 安装文件夹>\Samples\Web\WSDAPI\StockQuote)演示了具有基本消息传送功能的服务。 文件服务示例(位于 <Windows SDK 安装文件夹>\Samples\Web\WSDAPI\FileService)演示了具有高级功能(如异步消息传送、附件和事件)的服务。

这两个示例都包含以下类型的文件。

  • 包含服务说明的 WSDL 文件。
  • 用于生成 WSDAPI 代码的 WsdCodeGen 配置文件
  • 生成的 C++ 标头和源文件。
  • 客户端和服务实现文件。
  • Visual Studio 项目和解决方案文件。

这两个示例都实现了设备主机 (IWSDDeviceHost)、设备代理 (IWSDDeviceProxy) 和服务代理(IWSDServiceProxy)。 此外,文件服务示例还演示了如何使用异步消息传送(IWSDAsyncCallbackIWSDAsyncResult)、附件(IWSDInboundAttachmentIWSDOutboundAttachment)和事件。

示例随附的 FileServiceContract.vcproj 和 StockQuoteContract.vcproj 文件从 WsdCodeGen 配置文件中指定的 WSDL 文件调用 WsdCodeGen 以生成 C++ 标头和源文件。 这意味着,如果示例 WSDL 或 WsdCodeGen 配置文件发生了更改,会重新生成示例项目,WsdCodeGen 会自动生成体现更改的新标头和源文件。 这是生成 WSDAPI 应用程序的首选方法。 通常从命令行调用 WsdCodeGen。 可打开相关的 *.vcproj 文件,查看 WsdCodeGen 命令行调用示例。

Windows 上的 WSD 应用程序开发