IWSDDeviceHost::SignalEvent 方法 (wsdhost.h)
通知所有订阅的客户端已发生事件。
语法
HRESULT SignalEvent(
[in] LPCWSTR pszServiceId,
[in] const void *pBody,
[in] const WSD_OPERATION *pOperation
);
参数
[in] pszServiceId
生成事件的服务的 ID。
[in] pBody
事件的正文。
[in] pOperation
对指定操作 的 WSD_OPERATION 结构的引用。
返回值
可能的返回值包括但不限于以下值:
返回代码 | 说明 |
---|---|
|
方法已成功完成。 |
|
主机未启动。 调用 “开始”以 启动设备主机。 |
|
pszServiceId 为 NULL,pOperation 为 NULL,pszServiceId 的字符长度超过 WSD_MAX_TEXT_LENGTH (8192) ,没有与 pOperation 关联的 ResponseType 结构,或者 pszServiceId 指定的服务未订阅 pOperation 的 ResponseType 成员指定的事件。 |
注解
SignalEvent 将阻止,直到事件发送到所有客户端。 由于客户端是按顺序联系的,因此,如果任何客户端响应缓慢或无法访问, 则 SignalEvent 可能会长时间阻塞。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows Vista [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2008 [仅限桌面应用] |
目标平台 | Windows |
标头 | wsdhost.h (包括 Wsdapi.h) |
DLL | Wsdapi.dll |