PPCStartSync
PPCStartPBPtr pb; Pointer to PPC parameter block
On entry A0: pointer to a parameter block
D0: selector (2)
On exit D0: result code
Parameter block
Æ 12 ioCompletion long address of a completion routine
Æ 38 portRefNum short port reference number of this session
¨ 40 sessRefNum long session reference number of this session
Æ 44 serviceType char service type requested-must be
ppcServiceRealTime
Æ 45 resFlag char reserved field-must be 0
Æ 58 userData long application-specific data
PPCStart function initiates a session with the destination port specified in
the name and location fields.
If your application calls this function asynchronously, you must specify in
the ioCompletion field either the address of a completion routine or NIL. If
ioCompletion is NIL, you should poll the ioResult field of the
PPC parameter block (from your application's main event loop) to determine
the ioResult field other than 1 indicates that the call is complete. Note that it is
be in the process of completing a call.
of the fields in the parameter block until the call completes. The port name and
location name pointed to by the PPCStart parameter block record are owned
de allocated or moved in memory while the call is in progress.
You specify the PPC port identifier in the portRefNum field. The
port reference number is a reference number for the port through which you
are requesting a session. The value you specify must correspond to the
The sessRefNum field returns a session identifier. This number, which is
identify a particular session. You must set the serviceType field to indicate
that the session is to be connected in real time. For System 7.0+, this field
must always be set to the ppcServiceRealTime constant. You must set the
resFlag field to 0.
The portName field must contain a pointer to a PPC port record. The
locationName field should contain a pointer to a location name record or NIL.
of the PPC port to initiate a session with, and they are usually obtained from
location name record is ppcNoLocation or if the locationName pointer is NIL,
then the location is the local machine. If the locationKindSelector field in the
location name record is ppcNBPLocation, then the location is a remote
machine designated by the nbpEntity field of the location name record.
If the ioResult field of the PPC parameter block returns a userRejectErr
result code, the rejectInfo field contains the same value as the rejectInfo field
application.
The initiating port can specify any information in the userData field. The
PPCInform function reports this data to the responding port upon its
completion.
and a password. A user reference number of 0 indicates that you want to
specify a guest.
noErr (0) No error
nameTypeErr (-902) locationKindSelector is not ppcNBPLocation or
ppcNoLocation
noPortErr (-903) Bad port reference number
noGlobalsErr (-904) System unable to allocate memory, critical error
localOnlyErr (-905) Network activity is currently disabled
destPortErr (-906) Port does not exist at destination
noUserNameErr (-911) User name unknown on destination machine
userRejectErr (-912) Destination rejected the session request
noResponseErr (-915) Unable to contact application
portClosedErr (-916) The port was closed
badPortNameErr (-919) PPC port record is invalid
networkErr (-925) An error has occurred in the network
noInformErr (-926) PPCStart failed because target application did not have
an inform pending
authFailErr (-927) User's password is wrong
noUserRecErr (-928) Invalid user reference number
badServiceMethodErr (-930) Service method is other than ppcServiceRealTime
guestNotAllowedErr (-932) Destination port requires authentication