IWSDDeviceHost::SignalEvent-Methode (wsdhost.h)

Artikel
03/04/2024

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

Freigeben über