IWSDDeviceProxy::Init 方法 (wsdclient.h)

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

语法

HRESULT Init(
  [in]           LPCWSTR         pszDeviceId,
  [in]           IWSDAddress     *pDeviceAddress,
  [in]           LPCWSTR         pszLocalId,
  [in, optional] IWSDXMLContext  *pContext,
  [in, optional] IWSDDeviceProxy *pSponsor
);

参数

[in] pszDeviceId

设备的逻辑地址 (ID) 。

[in] pDeviceAddress

对包含设备配置数据的 IWSDAddress 对象的引用。

[in] pszLocalId

客户端的逻辑地址。 逻辑地址的格式为 urn:uuid:{guid}。 当服务器需要启动与客户端的连接时使用。

[in, optional] pContext

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

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

[in, optional] pSponsor

IWSDDeviceProxy 对象的引用,该对象是用于共享会话和下层的可选设备。

返回值

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

返回代码 说明
S_OK
方法已成功完成。
E_INVALIDARG
pszDeviceIdNULL,pszLocalIdNULL,或标识符字符串的长度(以字符为单位)超过 WSD_MAX_TEXT_LENGTH (8192) 。
E_OUTOFMEMORY
内存不足,无法完成操作。

注解

此方法由 WSDCreateDeviceProxy 调用,通常不需要由客户端代码直接调用。

要求

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

另请参阅

IWSDDeviceProxy