IWSDDeviceHost::SignalEvent-Methode (wsdhost.h)

  • Artikel

Benachrichtigt alle abonnierten Clients, dass ein Ereignis aufgetreten ist.

Syntax

HRESULT SignalEvent(
  [in] LPCWSTR             pszServiceId,
  [in] const void          *pBody,
  [in] const WSD_OPERATION *pOperation
);

Parameter

[in] pszServiceId

Die ID des Diensts, der das Ereignis generiert.

[in] pBody

Der Text des Ereignisses.

[in] pOperation

Verweis auf eine WSD_OPERATION-Struktur , die den Vorgang angibt.

Rückgabewert

Mögliche Rückgabewerte sind unter anderem folgendes:

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich abgeschlossen.
E_FAIL
 Der Host wurde nicht gestartet. Rufen Sie Start auf, um den Gerätehost zu starten.
E_INVALIDARG
 pszServiceId ist NULL, pOperation ist NULL, die Länge in Zeichen von pszServiceId überschreitet WSD_MAX_TEXT_LENGTH (8192), pOperation ist keine ResponseType-Struktur zugeordnet, oder der von pszServiceId angegebene Dienst wird nicht für das vom ResponseType-Member von pOperation angegebene Ereignis abonniert.

Hinweise

SignalEvent blockiert, bis das Ereignis an alle Clients gesendet wird. Da Clients sequenziell kontaktiert werden, ist es möglich, dass SignalEvent für eine lange Zeit blockiert wird, wenn ein Client langsam reagiert oder nicht erreichbar ist.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wsdhost.h (include Wsdapi.h)
DLL Wsdapi.dll

Weitere Informationen

IWSDDeviceHost