Important: The information in this document is obsolete and should not be used for new development.
AEResumeTheCurrentEvent
You can use theAEResumeTheCurrentEvent
function to inform the Apple Event Manager that your application wants to resume the handling of a previously suspended Apple event or that it has completed the handling of the Apple event.
FUNCTION AEResumeTheCurrentEvent (theAppleEvent, reply: AppleEvent; dispatcher: EventHandlerProcPtr; handlerRefcon: LongInt): OSErr;
theAppleEvent
- The Apple event to be resumed.
reply
- The default reply provided by the Apple Event Manager for the Apple event.
dispatcher
- One of the following:
- a pointer to a routine for handling the event
- the
kAEUseStandardDispatch
constant, which tells the Apple Event Manager to dispatch the resumed event using the standard dispatching scheme it uses for other Apple events- the
kAENoDispatch
constant, which tells the Apple Event Manager that the Apple event has been completely processed and need not be dispatched
handlerRefcon
If the value of thedispatcher
parameter is notkAEUseStandardDispatch
, this parameter is the reference constant passed to the handler when the handler is called. If the value of thedispatcher
parameter iskAEUseStandardDispatch
, the Apple Event Manager ignores thehandlerRefcon
parameter and instead passes the reference constant stored in the Apple event dispatch table entry for the Apple event. (You may wish to pass the same reference constant that is stored in the Apple event dispatch table. If so, call theAEGetEventHandler
function.)DESCRIPTION
When your application calls theAEResumeTheCurrentEvent
function, the Apple Event Manager resumes handling the specified Apple event using the handler specified in thedispatcher
parameter, if any. IfkAENoDispatch
is specified in thedispatcher
parameter,AEResumeTheCurrentEvent
simply informs the Apple Event Manager that the specified event has been handled.SPECIAL CONSIDERATIONS
An Apple event handler that suspends an event should not immediately callAEResumeTheCurrentEvent
, or else the handler will generate an error. Instead, the handler should return just after suspending the event.When your application calls
AEResumeTheCurrentEvent
for an event that was not directly dispatched, the Apple Event Manager disposes of the event and the reply, just as it normally does, after the event handler returns toAEProcessAppleEvent
. Make sure all processing involving the event or the reply has been completed before your application callsAEResumeTheCurrentEvent
. Do not callAEResumeTheCurrentEvent
for an event that was not suspended.When your application calls
AEResumeTheCurrentEvent
for an event that was directly dispatched, your application is responsible for disposing of the original event and the reply, since it is acts as both the server and the client.RESULT CODE
noErr 0 No error