AcceptHighLevelEvent

Accept a high-level event

#include <EPPC.h> Event Manager

OSErr AcceptHighLevelEvent(sender, msgRefcon, msgBuff, msglen);

TargetID *sender Sender identification

unsigned long *msgRefcon Event Identification Number

Ptr msgBuff Additional data associated with event

unsigned long *msgLen Message length

returns Error Code; 0=no error

sender is the address of a TargetID record which specifies the sender of

theEvent. The TargetID record contains the session reference

number that identifies this communication and the port name and

port location of the sender.

msgRefcon is a pointer to a unique number that is used to identify this event. If

you send a response to this event, you should specify the same value

of msgRefcon so that the sender of the event can associate the reply

with the original request.

msgBuff is a parameter which points to any additional data associated with

the event. The msgLen parameter contains the size of the buffer. Your

application is responsible for allocating the memory for the

additional data pointed to by the msgBuff parameter. If the msgBuff

parameter points to an area in memory that is not large enough for

all the data for the event, AcceptHighLevelEvent returns the

result code bufferIsSmall, the msgLen parameter contains the

number of bytes remaining. You can call AcceptHighLevelEvent

again to receive the rest of the data.

msgLen is a pointer to an unsigned long combining the number of bytes

remaining in the message buffer.

Returns: an operating system Error Code. It will be one of:

noErr (0) No error

bufferIsSmall (-607) Buffer is too small

noOutstandingHLE (-608) No outstanding high-level event

connectionInvalid (-609) Invalid connection

noUserInteractionAllowed (-610) No user interaction allowed