Represents a DPWS-compliant device . The device host will announce its presence on the network using the WS-Discovery protocol. The device host will also automatically respond to discovery queries and metadata requests.

The caller can register user-implemented services with the device host. These services will be exposed in the device metadata and the services will be available over the network. Messages bound for these services will be automatically dispatched into the service object.

Call WSDCreateDeviceHost or WSDCreateDeviceHostAdvanced to create an object that exposes this interface.

Methods

The IWSDDeviceHost interface inherits the methods of the IUnknown interface.

In addition, IWSDDeviceHost defines the following methods.

Remarks

After retrieving this interface, the application would then:

1. Call the RegisterPortType method to register all necessary port types.
2. Call SetMetadata to describe the device and optionally call RegisterService one or more times to register services described in the service host metadata.
3. Call the Start method to start the device host and to publish the device using WS-Discovery.

   After starting the device host, you can optionally:

   1. Call AddDynamicService for services not described in the service host metadata (for example, an ad hoc print job).
   2. Call RetireService to terminate action on and disconnect a service activated by the RegisterService method.
   3. Call the SignalEvent method to indicate that notifications should be sent for subscriptions relating to a particular event.
4. Call the Stop method to terminate host execution and terminate publication of the device.

An IWSDDeviceHost object can provide an object for a service on demand (using a notification callback) when calling the host receives a request message directed at that service.

Requirements

See Also

Overview of the WSDAPI Interfaces

Send comments about this topic to Microsoft

Build date: 11/6/2009