IWSDServiceProxy interface (wsdclient.h)
Represents a remote WSD service for client applications and middleware.
Inheritance
The IWSDServiceProxy interface inherits from IWSDMetadataExchange. IWSDServiceProxy also has these types of members:
Methods
The IWSDServiceProxy interface has these methods.
| IWSDServiceProxy::BeginGetMetadata Initiates an asynchronous metadata exchange request with the remote service. |
| IWSDServiceProxy::EndGetMetadata Completes the asynchronous metadata exchange request and retrieves the service metadata from the response. |
| IWSDServiceProxy::GetEndpointProxy Gets the endpoint proxy for the device. |
| IWSDServiceProxy::GetServiceMetadata Retrieves the metadata for the IWSDServiceProxy object. |
| IWSDServiceProxy::SetEventingStatusCallback Sets or clears the eventing status callback. |
| IWSDServiceProxy::SubscribeToOperation Subscribes to a notification or solicit/response event. |
| IWSDServiceProxy::UnsubscribeToOperation Cancels a subscription to a notification or solicit/response event. |
Remarks
Service proxy objects may reside on multiple endpoints. An endpoint more completely represents a URL (contains additional useful data). For example, one endpoint may support HTTP on IPv4 addresses and another may support HTTPS on IPv6 addresses. Since the same service lives on both endpoints, it is important that the service have underlying endpoint proxy objects, with each endpoint proxy corresponding to a single endpoint at which the service is available. The endpoint proxy takes care of simple messaging requests to the service, for example, sending one-way or two-way messages.
IWSDServiceProxy objects are employed to obtain service metadata, send messages to the service through a service proxy, subscribe to events on the service, and bind to proxies that provide type-specific semantics.
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) |