IRawElementProviderAdviseEvents::AdviseEventRemoved-Methode (uiautomationcore.h)

  • Artikel

Benachrichtigt den Microsoft UI Automation-Anbieter, wenn ein Benutzeroberflächenautomatisierungsclient nicht mehr auf ein bestimmtes Ereignis lauscht, einschließlich eines Eigenschaftsänderungsereignisses.

Syntax

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

Parameter

[in] eventId

Typ: EVENTID

Der Bezeichner des zu entfernenden Ereignisses. Eine Liste der Ereignis-IDs finden Sie unter Ereignisbezeichner.

[in] propertyIDs

Typ: SAFEARRAY*

Ein Zeiger auf die Bezeichner der entfernten Eigenschaften oder NULL , wenn der entfernte Ereignislistener nicht auf Eigenschaftsereignisse lauscht.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Methode ermöglicht es dem Anbieter, den Mehraufwand zu reduzieren, indem nur Ereignisse ausgelöst werden, auf die lauscht wird.

Für Benutzeroberflächenautomatisierungsanbieter ist es wichtig, die IRawElementProviderAdviseEvents::AdviseEventRemoved-Methode wie die Release-Methode der IUnknown-Schnittstelle zu behandeln. Solange AdviseEventAdded für ein bestimmtes Ereignis oder eine bestimmte Eigenschaft öfter aufgerufen wurde als AdviseEventRemoved , sollte der Anbieter weiterhin entsprechende Ereignisse auslösen, da einige Clients weiterhin lauschen. Alternativ können Benutzeroberflächenautomatisierungsanbieter die Funktion UiaClientsAreListening verwenden, um zu bestimmen, ob mindestens ein Client lauscht, und wenn ja, alle entsprechenden Ereignisse auslösen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile uiautomationcore.h (include UIAutomation.h)

Weitere Informationen

Bewährte Methoden für die Verwendung sicherer Arrays

Konzept

IRawElementProviderAdviseEvents

Referenz