IWSDDeviceProxy

Other versions of this page are also available for the following:

• Windows Embedded CE 6.0 R3

8/28/2008

This interface represents a remote DPWS device for client applications and middleware. To get this interface, call WSDCreateDeviceProxy.

The IWSDDeviceProxy interface inherits the methods of the IUnknown interface.

In addition, the following table lists the methods supported by the IWSDDeviceProxy interface in vtable order.

Method	Description
IWSDDeviceProxy::Init	Initializes the device proxy, optionally sharing a session with a previously initialized sponsoring device proxy.
IWSDDeviceProxy::BeginGetMetadata	Sends an asynchronous request for metadata.
IWSDDeviceProxy::EndGetMetadata	Ends an asynchronous request for metadata and returns the metadata related to a device.
IWSDDeviceProxy::GetHostMetadata	Gets class-specific metadata for the device describing the features of the device and the services it hosts.
IWSDDeviceProxy::GetThisModelMetadata	Gets model-specific metadata for the device.
IWSDDeviceProxy::GetThisDeviceMetadata	Gets device-specific metadata for this device.
IWSDDeviceProxy::GetAllMetadata	Gets all metadata for this device.
IWSDDeviceProxy::GetServiceProxyById	Gets a generic IWSDServiceProxy service proxy by service ID. Service IDs can be obtained by examining the service host metadata.
IWSDDeviceProxy::GetServiceProxyByType	Gets a generic IWSDServiceProxy proxy for a service exposed by the device by port type name.
IWSDDeviceProxy::GetEndpointProxy	Gets the endpoint proxy for the device.

Remarks

This interface is a client-side representation of a remote device. The proxy provides basic access to device metadata (WSD_THIS_DEVICE_METADATA and WSD_THIS_MODEL_METADATA), in addition to providing methods for creating service proxy objects. The service proxy objects correspond to service hosted on the device. For example, a television is a device and the tuner portion of the television is a service hosted on the device that has an accessible, atomic set of functions.

The IWSDDeviceProxy object exposes WSD-specific device semantics. To use IWSDDeviceProxy in a client or middleware application, take the following action:

1. Call WSDCreateDeviceProxy.
2. Call any of the four metadata methods of the device proxy object.
3. Get an IWSDServiceProxy object, either by calling GetServiceProxyById or GetServiceProxyByType.

Requirements

Header	wsdapi.h
Library	wsdapi.lib
Windows Embedded CE	Windows Embedded CE 6.0 R2

See Also

Reference

Web Services on Devices Interfaces
Web Services on Devices Reference