Een haakfunctie registreren

Clienttoepassingen ontvangen WinEvents in een WinEventProc callback-functie. De acties die door de callback-functie worden uitgevoerd, worden gedefinieerd door de toepassing, maar de syntaxis moet worden opgegeven in het prototype.

Voordat deze gebeurtenissen kan ontvangen, moet de functie worden geregistreerd door SetWinEventHook-aan te roepen. De client kan SetWinEventHook meerdere keren aanroepen om verschillende hookfuncties te registreren of om extra gebeurtenissen in te stellen voor een eerder geregistreerde hook-functie.

Bij het aanroepen van SetWinEventHook geeft de client op welke gebeurtenissen moeten worden ontvangen en hoe deze moeten worden ontvangen. De client kan kiezen uit:

• Alle gebeurtenissen of een specifieke set gebeurtenissen ontvangen.
• Gebeurtenissen ontvangen van alle threads of van een specifieke thread.
• Gebeurtenissen ontvangen van alle processen of van een specifiek proces.
• Gebeurtenissen verwerken in het proces of buiten het proces.

Wanneer een gebeurtenis wordt gegenereerd die voldoet aan de opgegeven criteria, roept het systeem de WinEventProc- callback-functie (of "hook procedure") aan. De parameters die de hookfunctie ontvangt, vertellen de client over het venster, het object en het mogelijke onderliggende element dat de gebeurtenis heeft gegenereerd. Een client gebruikt deze parameters in een aanroep voor het ophalen van objecten, zoals AccessibleObjectFromEvent.