IWSDDeviceProxy interface (wsdclient.h)
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:
- Call WSDCreateDeviceProxy.
- Call any of the four metadata methods of the device proxy object.
- 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) |