Horogfüggvény regisztrálása
Az kliensalkalmazások WinEvents-eket kapnak egy WinEventProc visszahívási függvényben. A visszahívási függvény által végrehajtott műveleteket az alkalmazás határozza meg, de a szintaxisnak a prototípusban megadott módon kell lennie.
Az események fogadása előtt a függvényt regisztrálni kell SetWinEventHookmeghívásával. Az ügyfél több alkalommal is meghívhatja SetWinEventHook különböző horogfüggvények regisztrálásához, vagy egy korábban regisztrált horogfüggvény további eseményeinek beállításához.
A SetWinEventHookhívásakor az ügyfél megadja, hogy mely eseményeket és hogyan fogadhatja őket. Az ügyfél a következő lehetőségek közül választhat:
- Fogadhatja az összes eseményt vagy egy adott eseménykészletet.
- Események fogadása az összes szálról vagy egy adott szálról.
- Események fogadása az összes folyamatból vagy egy adott folyamatból.
- Folyamaton kívüli vagy folyamatban lévő események kezelése.
A megadott feltételeknek megfelelő esemény létrehozásakor a rendszer meghívja az ügyfél WinEventProc visszahívási függvényt (vagy "horog eljárást"). A hook függvény által kapott paraméterek tájékoztatják az ügyfelet az eseményt létrehozó ablakról, objektumról és esetleges alelmentől. Az ügyfél ezeket a paramétereket egy objektumlekérési hívásban használja, például AccessibleObjectFromEvent.