Edit

IWSDDeviceProxy interface (wsdclient.h)

  • Article

Represents a remote Devices Profile for Web Services (DPWS) device for client applications and middleware.

To get this interface, you can call WSDCreateDeviceProxy.

Inheritance

The IWSDDeviceProxy interface inherits from the IUnknown interface. IWSDDeviceProxy also has these types of members:

Methods

The IWSDDeviceProxy interface has these methods.

 
IWSDDeviceProxy::BeginGetMetadata

Sends an asynchronous request for metadata.
IWSDDeviceProxy::EndGetMetadata

Ends an asynchronous request for metadata.
IWSDDeviceProxy::GetAllMetadata

Retrieves all metadata for this device.
IWSDDeviceProxy::GetEndpointProxy

Retrieves the endpoint proxy for the device.
IWSDDeviceProxy::GetHostMetadata

Retrieves class-specific metadata for the device describing the features of the device and the services it hosts.
IWSDDeviceProxy::GetServiceProxyById

Retrieves a generic IWSDServiceProxy service proxy by service ID.
IWSDDeviceProxy::GetServiceProxyByType

Retrieves a generic IWSDServiceProxy proxy for a service exposed by the device by port type name.
IWSDDeviceProxy::GetThisDeviceMetadata

Retrieves device-specific metadata for this device.
IWSDDeviceProxy::GetThisModelMetadata

Retrieves model-specific metadata for the device.
IWSDDeviceProxy::Init

Initializes the device proxy, optionally sharing a session with a previously initialized sponsoring device proxy.

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 your client or middleware application:

  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

Requirement Value
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header wsdclient.h (include Wsdapi.h)

See also

Overview of the WSDAPI Interfaces