通过

WSDCreateDeviceProxy 函数 (wsdclient.h)

  • 项目

创建设备代理并返回指向 IWSDDeviceProxy 接口的指针。

语法

HRESULT WSDCreateDeviceProxy(
  [in]  LPCWSTR         pszDeviceId,
  [in]  LPCWSTR         pszLocalId,
  [in]  IWSDXMLContext  *pContext,
  [out] IWSDDeviceProxy **ppDeviceProxy
);

参数

[in] pszDeviceId

设备的逻辑或物理地址。 逻辑地址的形式 urn:uuid:{guid}为 。 物理地址是前缀为 http 或 https 的 URI。 如果此地址是前缀为 https 的 URI，则代理将使用 SSL/TLS 协议。

设备地址可能以 @ 字符为前缀。 当 pszDeviceId 以 @开头时，此函数在创建设备代理时不会检索设备元数据。

[in] pszLocalId

客户端的逻辑或物理地址，用于标识代理并充当事件接收器终结点。 逻辑地址的形式 urn:uuid:{guid}为 。

如果客户端使用安全通道来接收事件，则地址是前缀为 https 的 URI。 此 URI 应指定端口 5358，因为此端口是为使用 WSDAPI 进行安全连接而保留的。 在调用 WSDCreateDeviceProxyAdvanced 之前，必须使用 SSL 服务器证书配置端口。 有关端口配置的详细信息，请参阅 HttpSetServiceConfiguration。

[in] pContext

定义自定义消息类型或命名空间的 IWSDXMLContext 对象。

如果 为 NULL，则使用表示内置消息类型和命名空间的默认上下文。

[out] ppDeviceProxy

指向 IWSDDeviceProxy 对象的指针，该对象用于表示客户端应用程序和中间件的远程 WSD 设备。

返回值

可能的返回值包括但不限于以下内容：

返回代码 说明
S_OK
 方法已成功完成。
E_INVALIDARG
 pszDeviceId 为 NULL， pszLocalId 为 NULL， pszDeviceId 的字符长度超过 WSD_MAX_TEXT_LENGTH (8192) ，或者 pszLocalId 的字符长度超过 WSD_MAX_TEXT_LENGTH (8192) 。
E_POINTER
 ppDeviceProxy 为 NULL。
E_OUTOFMEMORY
 内存不足，无法完成操作。

注解

WSDCreateDeviceProxy 函数调用 IWSDDeviceProxy：：Init 方法，该方法初始化 IWSDDeviceProxy 对象的实例。

除非 pszDeviceId 参数以 @ 字符开头，否则此函数还将检索设备元数据。 若要在创建设备代理后检索设备元数据，请在返回的 IWSDDeviceProxy 对象上调用 IWSDDeviceProxy：：BeginGetMetadata 和 IWSDDeviceProxy：：EndGetMetadata。

有关 对 WSDCreateDeviceProxy 函数调用进行故障排除的信息，请参阅 WSDAPI 应用程序疑难解答。

要求

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

另请参阅

WSDAPI 应用程序疑难解答