Interface IWbemEventSink (wbemprov.h)
L’interface IWbemEventSink lance la communication avec un fournisseur d’événements à l’aide d’un ensemble restreint de requêtes. Cette interface étend IWbemObjectSink, en fournissant de nouvelles méthodes traitant de la sécurité et des performances. Pour plus d’informations sur l’utilisation de cette interface, consultez Écriture d’un fournisseur d’événements et Sécurisation des événements WMI.
Héritage
L’interface IWbemEventSink hérite de l’interface IUnknown. IWbemEventSink a également les types de membres suivants :
Méthodes
L’interface IWbemEventSink possède les méthodes suivantes.
|
IWbemEventSink ::GetRestrictedSink La méthode IWbemEventSink ::GetRestrictedSink récupère un récepteur d’événements restreint. Un récepteur d’événements restreint est un récepteur qui filtre un sous-ensemble des événements définis dans l’inscription du fournisseur d’événements. |
|
IWbemEventsink ::IsActive La méthode IWbemEventSink ::IsActive est utilisée par le fournisseur pour déterminer s’il existe un intérêt pour les événements que le récepteur filtre. |
|
IWbemEventSink ::SetBatchingParameters La méthode IWbemEventSink ::SetBatchingParameters est utilisée pour définir la taille maximale de la mémoire tampon d’événements et la valeur de latence de traitement associée. |
|
IWbemEventSink ::SetSinkSecurity Permet de définir un descripteur de sécurité (SD) sur un récepteur pour tous les événements en transit. |
Remarques
Lors de l’implémentation d’un récepteur d’abonnement aux événements (IWbemObjectSink ou IWbemEventSink), n’appelez pas WMI à partir des méthodes de l’objet récepteur. Par exemple, l’appel d’IWbemServices::CancelAsyncCall pour annuler le récepteur à partir d’une implémentationIWbemEventSink::SetSinkSecurity peut interférer avec l’état WMI. Pour annuler un abonnement aux événements, définissez un indicateur et appelez IWbemServices::CancelAsyncCall à partir d’un autre thread ou objet. Pour les implémentations qui ne sont pas liées à un récepteur d’événements, telles que les récupérations d’objets, d’énumérations et de requêtes, vous pouvez rappeler WMI.
Les implémentations de récepteur doivent traiter la notification d’événement dans un délai de 100 ms, car le thread WMI qui transmet la notification d’événement ne peut pas effectuer d’autres tâches tant que l’objet récepteur n’a pas terminé le traitement. Si la notification nécessite une grande quantité de traitement, le récepteur peut utiliser une file d’attente interne pour un autre thread pour gérer le traitement.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista |
| Serveur minimal pris en charge | Windows Server 2008 |
| Plateforme cible | Windows |
| En-tête | wbemprov.h (include Wbemidl.h) |