Important: The information in this document is obsolete and should not be used for new development.
PPCAccept
Use thePPCAccept
function to indicate that an application is willing to accept an incoming session request after aPPCInform
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 thePPCAccept
function asynchronously, you must specify in theioCompletion
field either the address of a completion routine orNIL
. If you setioCompletion
toNIL
, you should poll theioResult
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 theioResult
field other than 1 indicates that the call is complete. Note that it is unsafe to poll theioResult
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 completedPPCInform
parameter block to accept the session request.ASSEMBLY-LANGUAGE INFORMATION
The trap macro and routine selector for thePPCAccept
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 thePPCAccept
function, see "Accepting or Rejecting Session Requests" beginning on page 11-37.