iWSDDeviceProxy 接口 (wsdclient.h)

表示 Web 服务的远程设备配置文件, (客户端应用程序和中间件的 DPWS) 设备。

若要获取此接口,可以调用 WSDCreateDeviceProxy

继承

IWSDDeviceProxy 接口继承自 IUnknown 接口。 IWSDDeviceProxy 还具有以下类型的成员:

方法

IWSDDeviceProxy 接口包含以下方法。

 
IWSDDeviceProxy::BeginGetMetadata

发送元数据的异步请求。
IWSDDeviceProxy::EndGetMetadata

结束对元数据的异步请求。
IWSDDeviceProxy::GetAllMetadata

检索此设备的所有元数据。
IWSDDeviceProxy::GetEndpointProxy

检索设备的终结点代理。
IWSDDeviceProxy::GetHostMetadata

检索设备的类特定元数据,描述设备及其承载的服务的功能。
IWSDDeviceProxy::GetServiceProxyById

按服务 ID 检索泛型 IWSDServiceProxy 服务代理。
IWSDDeviceProxy::GetServiceProxyByType

检索设备按端口类型名称公开的服务的泛型 IWSDServiceProxy 代理。
IWSDDeviceProxy::GetThisDeviceMetadata

检索此设备的特定于设备的元数据。
IWSDDeviceProxy::GetThisModelMetadata

检索设备的模型特定元数据。
IWSDDeviceProxy::Init

初始化设备代理,可以选择与以前初始化的赞助设备代理共享会话。

注解

此接口是远程设备的客户端表示形式。 除了提供创建服务代理对象的方法外,代理还提供对设备元数据的基本访问 (WSD_THIS_DEVICE_METADATAWSD_THIS_MODEL_METADATA) 。 服务代理对象对应于设备上托管的服务。 例如,电视是设备,电视的调谐器部分是设备上托管的服务,具有可访问的原子功能集。

IWSDeviceProxy 对象公开特定于 WSD 的设备语义。

若要在客户端或中间件应用程序中使用 IWSDDeviceProxy ,请执行以下操作:

  1. 调用 WSDCreateDeviceProxy
  2. 调用设备代理对象的四个元数据方法中的任何一个。
  3. 通过调用 GetServiceProxyById 或 GetServiceProxyByType 获取 IWSDServiceProxy 对象。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 wsdclient.h (包括 Wsdapi.h)

另请参阅

WSDAPI 接口概述