Metodo IWSDDeviceHost::SignalEvent (wsdhost.h)

Articolo
03/04/2024

Notifica a tutti i client sottoscritti che si è verificato un evento.

Sintassi

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

Parametri

[in] pszServiceId

ID del servizio che genera l'evento.

[in] pBody

Corpo dell'evento.

[in] pOperation

Riferimento a una struttura WSD_OPERATION che specifica l'operazione.

Valore restituito

I valori restituiti possibili includono, ma non sono limitati ai seguenti:

Codice restituito	Descrizione
S_OK	Il metodo è stato completato correttamente.
E_FAIL	L'host non viene avviato. Chiamare Start per avviare l'host del dispositivo.
E_INVALIDARG	pszServiceId è NULL, pOperation è NULL, la lunghezza in caratteri di pszServiceId supera WSD_MAX_TEXT_LENGTH (8192), non esiste una struttura ResponseType associata a pOperation o il servizio specificato da pszServiceId non è sottoscritto all'evento specificato dal membro ResponseType di pOperation.

Commenti

SignalEvent si blocca finché l'evento non viene inviato a tutti i client. Poiché i client vengono contattati in sequenza, è possibile che SignalEvent blocchi per molto tempo se un client risponde lentamente o non è raggiungibile.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	wsdhost.h (include Wsdapi.h)
DLL	Wsdapi.dll

Vedi anche

IWSDDeviceHost

Condividi tramite