IWSDDeviceHost::SignalEvent 方法 (wsdhost.h)
通知所有已訂閱的用戶端發生事件。
語法
HRESULT SignalEvent(
[in] LPCWSTR pszServiceId,
[in] const void *pBody,
[in] const WSD_OPERATION *pOperation
);
參數
[in] pszServiceId
產生事件之服務的標識碼。
[in] pBody
事件的主體。
[in] pOperation
指定作業 之WSD_OPERATION 結構的參考。
傳回值
可能的傳回值包括但不限於下列各項:
傳回碼 | 描述 |
---|---|
|
方法已順利完成。 |
|
主機未啟動。 呼叫 [開始] 以啟動裝置主機。 |
|
pszServiceId 為 NULL、pOperation 為 NULL、pszServiceId 的字元長度超過 WSD_MAX_TEXT_LENGTH (8192) 、沒有與 pOperation 相關聯的 ResponseType 結構,或 pszServiceId 所指定的服務未訂閱 pOperation 成員所指定的事件。 |
備註
SignalEvent 會封鎖直到事件傳送至所有客戶端為止。 由於用戶端會循序連絡,因此如果有任何用戶端回應緩慢或無法連線, SignalEvent 可能會長時間封鎖。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | wsdhost.h (包含 Wsdapi.h) |
Dll | Wsdapi.dll |