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 对象的引用。

返回值

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

返回代码 说明
S_OK
方法已成功完成。
S_FALSE
设备主机已启动。
E_FAIL
方法失败。 它可能已失败,因为主机尚未初始化。 调用 Init 以初始化设备主机。
E_ABORT
没有与主机关联的元数据。

要求

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

另请参阅

IWSDDeviceHost