Méthode IRawElementProviderAdviseEvents::AdviseEventRemoved (uiautomationcore.h)

Avertit le fournisseur Microsoft UI Automation lorsqu’un client UI Automation cesse d’écouter un événement spécifique, y compris un événement de modification de propriété.

Syntaxe

HRESULT AdviseEventRemoved(
  [in] EVENTID   eventId,
  [in] SAFEARRAY *propertyIDs
);

Paramètres

[in] eventId

Type : EVENTID

Identificateur de l’événement en cours de suppression. Pour obtenir la liste des ID d’événement, consultez Identificateurs d’événements.

[in] propertyIDs

Type : SAFEARRAY*

Pointeur vers les identificateurs des propriétés supprimées ou NULL si l’écouteur d’événements supprimé n’écoute pas les événements de propriété.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Cette méthode permet au fournisseur de réduire la surcharge en activant uniquement les événements qui sont écoutés.

Il est important que les fournisseurs UI Automation traitent IRawElementProviderAdviseEvents::AdviseEventRemoved comme la méthode Release de l’interface IUnknown . Tant qu’AdviseEventAdded a été appelé plus de fois qu’AdviseEventRemoved pour un événement ou une propriété spécifique, le fournisseur doit continuer à déclencher les événements correspondants, car certains clients sont toujours à l’écoute. Les fournisseurs UI Automation peuvent également utiliser la fonction UiaClientsAreListening pour déterminer si au moins un client écoute et, le cas échéant, déclencher tous les événements appropriés.

Configuration requise

Voir aussi

Meilleures pratiques pour l’utilisation de tableaux sécurisés

Conceptuel

IRawElementProviderAdviseEvents

Référence