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

  • Article

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