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 结构的引用。

返回值

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

返回代码 说明
S_OK
方法已成功完成。
E_FAIL
主机未启动。 调用 “开始”以 启动设备主机。
E_INVALIDARG
pszServiceIdNULL,pOperationNULL,pszServiceId 的字符长度超过 WSD_MAX_TEXT_LENGTH (8192) ,没有与 pOperation 关联的 ResponseType 结构,或者 pszServiceId 指定的服务未订阅 pOperationResponseType 成员指定的事件。

注解

SignalEvent 将阻止,直到事件发送到所有客户端。 由于客户端是按顺序联系的,因此,如果任何客户端响应缓慢或无法访问, 则 SignalEvent 可能会长时间阻塞。

要求

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

另请参阅

IWSDDeviceHost