Legacy Document

Inside Macintosh: Interapplication Communication /

Chapter 11 - Program-to-Program Communications Toolbox / PPC Toolbox Reference

PPC Toolbox Routines / Receiving, Accepting, and Rejecting a Session

PPCAccept

Use the PPCAccept function to indicate that an application is willing to accept an incoming session request after a PPCInform function completes.

FUNCTION PPCAccept (pb: PPCAcceptPBPtr; async: Boolean): OSErr;

pb

A pointer to a PPCAccept parameter block.

async

A value that specifies whether the function is to be executed asynchronously (TRUE) or synchronously (FALSE).

-->	ioCompletion	PPCCompProcPtr	Address of a completion routine
<--	ioResult	OSErr	Result code
-->	sessRefNum	PPCSessRefNum	Session reference number of session to accept

DESCRIPTION

If your application calls the PPCAccept function asynchronously, you must specify in the ioCompletion field either the address of a completion routine or NIL. If you set ioCompletion to NIL, you should poll the ioResult field of the PPC parameter block (from your application's main event loop) to determine whether the PPC Toolbox has completed the requested operation. A value in the ioResult field other than 1 indicates that the call is complete. Note that it is unsafe to poll the ioResult field at interrupt time since the PPC Toolbox may be in the process of completing a call. See "PPC Toolbox Calling Conventions" beginning on page 11-14 for detailed information.

The sessRefNum field specifies a session identifier. Use the session reference number returned from the completed PPCInform parameter block to accept the session request.

ASSEMBLY-LANGUAGE INFORMATION

The trap macro and routine selector for the PPCAccept function are

Trap macro	Selector
_PPC	$0004

The registers on entry and exit for this routine are

Registers on entry
A0	Pointer to a parameter block
D0	Selector code

Registers on exit
D0	Result code

RESULT CODES

noErr	0	No error
notInitErr	-900	PPC Toolbox has not been initialized yet
noGlobalsErr	-904	System unable to allocate memory, critical error
noSessionErr	-908	Invalid session reference number
badReqErr	-909	Bad parameter or invalid state for this operation

SEE ALSO

For an example of the use of the PPCAccept function, see "Accepting or Rejecting Session Requests" beginning on page 11-37.