Méthode IWSDDeviceHost ::SignalEvent (wsdhost.h)

Article
03/04/2024

Avertit tous les clients abonnés qu’un événement s’est produit.

Syntaxe

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

Paramètres

[in] pszServiceId

ID du service qui génère l’événement.

[in] pBody

Corps de l’événement.

[in] pOperation

Référence à une structure WSD_OPERATION qui spécifie l’opération.

Valeur retournée

Les valeurs de retour possibles incluent, sans s’y limiter, les éléments suivants :

Code de retour	Description
S_OK	Méthode terminée avec succès.
E_FAIL	L’hôte n’est pas démarré. Appelez Démarrer pour démarrer l’hôte de l’appareil.
E_INVALIDARG	pszServiceId a la valeur NULL, pOperation a la valeur NULL, la longueur en caractères de pszServiceId dépasse WSD_MAX_TEXT_LENGTH (8192), aucune structure ResponseType n’est associée à pOperation, ou le service spécifié par pszServiceId n’est pas abonné à l’événement spécifié par le membre ResponseType de pOperation.

Remarques

SignalEvent se bloque jusqu’à ce que l’événement soit envoyé à tous les clients. Étant donné que les clients sont contactés séquentiellement, il est possible que SignalEvent se bloque pendant une longue période si un client répond lentement ou est inaccessible.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wsdhost.h (inclure Wsdapi.h)
DLL	Wsdapi.dll

Voir aussi

IWSDDeviceHost

Partager via