Edit

WSDAPI Basic Interoperability Tool

  • Article

The Devices Profile for Web Services (DPWS) is a reference specification that assembles and constrains a number of Web Services (WS) specifications. The Web Services on Devices (WSD) API (WSDAPI) is an implementation of DPWS that is included with Windows. Windows uses WSDAPI to discover DPWS devices of any type, and also uses WSDAPI to issue control messages to several device classes, such as printers, scanners, and network projectors.

The WSDAPI Basic Interoperability Tool (WSDBIT) can be used to verify that Windows can interoperate with non-WSDAPI DPWS stacks. This tool is intended primarily for device developers who are implementing DPWS and who want to test interoperability with Windows. Some WSDBIT tests require that the device implement a special test interface that is used to exercise advanced DPWS functionality, such as SOAP Message Transmission Optimization Mechanism (MTOM) (which is used for message attachments) and Web Services Eventing. These interfaces are not strictly required. However, they are the only way to cover this functionality in WSDBIT.

WSDAPI implements both the client and device sections of the specifications, and WSDBIT can be used to exercise WSDAPI as a client or as a device. WSDBIT can be used to test and verify a non-WSDAPI device or a non-WSDAPI client.

Before you read about the WSD interoperability tool, you should be familiar with the DPWS specification and its referenced specifications.

Note

WSDBIT may be used to assist with the implementation of DPWS on a device, but it is not intended to be a generic debugging tool. Other WSDAPI development tools (such as the WSDAPI debugging tools) are better suited to observing traffic and diagnosing failures. These tools are available in the Windows SDK for desktop apps, see Downloads for developing desktop apps.

This section includes the following topics:

Introduction to WSDBIT

Referenced Namespaces

WSDBIT Testing Environment

Client Scenarios for WSDBIT

WSDBIT Reference

For more information about WSD and WSDAPI, see the following topics in the Windows Software Development Kit (SDK):