IWbemEventProvider ::P rovideEvents, méthode (wbemprov.h)

Windows Management appelle la méthode IWbemEventProvider ::P rovideEvents pour signaler à un fournisseur d’événements qu’il commence la remise de ses événements.

Syntaxe

HRESULT ProvideEvents(
  [in] IWbemObjectSink *pSink,
  [in] long            lFlags
);

Paramètres

[in] pSink

Pointeur vers le récepteur d’objets auquel le fournisseur livrera ses événements. Dans une implémentation de fournisseur d’événements, vous devez utiliser la méthode IWbemObjectSink ::Indicate pour envoyer des événements via pSink. Cela contraste avec d’autres fournisseurs qui peuvent utiliser la méthode SetStatus : la méthode ProvideEvents ne doit utiliser qu’Indique pour mettre à jour un récepteur.

[in] lFlags

Réservé. Ce paramètre doit être 0.

Valeur retournée

Cette méthode retourne une valeur HRESULT qui indique le statut de l'appel de méthode. La liste suivante répertorie la valeur contenue dans un HRESULT.

Remarques

Windows Management appelle cette méthode pour activer le fournisseur. Windows Management fournit un pointeur IWbemObjectSink vers le fournisseur d’événements. Le fournisseur doit appeler la méthode AddRef à l’aide de ce pointeur pour incrémenter le nombre de références, puis retourner à partir de l’appel.

En règle générale, le fournisseur crée un thread indépendant et remet les événements à mesure qu’ils se produisent dans l’interface récepteur fournie.

Le fournisseur n’est pas autorisé à bloquer cet appel pendant plus de quelques secondes, mais il doit revenir aussi rapidement que possible à Windows Management.

Configuration requise