Поделиться через

Метод 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 , задающую операцию.

Возвращаемое значение

Возможные возвращаемые значения включают, помимо прочего, следующие:

Код возврата Описание
S_OK
 Метод успешно завершен.
E_FAIL
 Узел не запущен. Вызовите start , чтобы запустить узел устройства.
E_INVALIDARG
 pszServiceId имеет значение NULL, pOperation — NULL, длина в символах pszServiceId превышает WSD_MAX_TEXT_LENGTH (8192), нет структуры ResponseType , связанной с pOperation, или служба, указанная в pszServiceId , не подписана на событие, указанное в элементе ResponseTypepOperation.

Комментарии

SignalEvent блокируется до тех пор, пока событие не будет отправлено всем клиентам. Так как клиенты связываются последовательно, возможно, SignalEvent будет блокироваться в течение длительного времени, если какой-либо клиент реагирует медленно или недостижим.

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header wsdhost.h (включая Wsdapi.h)
DLL Wsdapi.dll

См. также раздел

IWSDDeviceHost