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 对象的引用,该对象是用于共享会话和下层的可选设备。
返回值
可能的返回值包括但不限于以下内容:
返回代码 | 说明 |
---|---|
|
方法已成功完成。 |
|
pszDeviceId 为 NULL,pszLocalId 为 NULL,或标识符字符串的长度(以字符为单位)超过 WSD_MAX_TEXT_LENGTH (8192) 。 |
|
内存不足,无法完成操作。 |
注解
此方法由 WSDCreateDeviceProxy 调用,通常不需要由客户端代码直接调用。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | wsdclient.h (包括 Wsdapi.h) |
DLL | Wsdapi.dll |