IWSDDeviceHost::Start 方法 (wsdhost.h)
启动设备主机并使用 WS-Discovery Hello 消息发布设备主机。 如果将通知接收器传递给此方法,则也会注册通知接收器。 成功调用 “开始”菜单 后,设备主机将自动响应“探测”和“解决”消息。
语法
HRESULT Start(
[in] ULONGLONG ullInstanceId,
[in] const WSD_URI_LIST *pScopeList,
[in, optional] IWSDDeviceHostNotify *pNotificationSink
);
参数
[in] ullInstanceId
实例标识符。 如果未提供标识符,则使用当前实例值 + 1 作为默认值。
注意 为了与 WS-Discovery 规范兼容,此值必须小于或等于 UINT_MAX (4294967295) 。
[in] pScopeList
设备主机的范围。 如果 为 NULL,则不与主机关联任何范围。
[in, optional] pNotificationSink
对指定通知接收器的 IWSDDeviceHostNotify 对象的引用。
返回值
可能的返回值包括但不限于以下值:
返回代码 | 说明 |
---|---|
|
方法已成功完成。 |
|
设备主机已启动。 |
|
方法失败。 它可能已失败,因为主机尚未初始化。 调用 Init 以初始化设备主机。 |
|
没有与主机关联的元数据。 |
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | wsdhost.h (包括 Wsdapi.h) |
DLL | Wsdapi.dll |