int func = hw_GetEventHandler(STRPTR name, struct hwTagList *tags);

If the script currently doesn't listen to the event handler, i.e. the script didn't install a callback for this event using InstallEventHandler(), hw_GetEventHandler() will return -1. Otherwise, a reference value is returned which can be used to obtain the callback function from the Lua registry.

Additionally, you can pass a tag list containing the following tags:

HWGEHTAG_USERDATA:

Set the pData of this tag to a pointer to an int and hw_GetEventHandler() will store the reference to the user data associated with this event handler in this pointer. If there is no user data associated with the event handler, hw_GetEventHandler() will write -1 to the pointer.

name

name of the event type; must be identical to the name passed tohw_RegisterEventHandler() or hw_RegisterEventHandlerEx()

tags

tag list containing further options or NULL

func

reference to user callback function for this event handler or -1