OP Start Remote Connection

version 1.5

OP Start Remote Connection (path; user; password; async) Longint

Parameter	Type		Description
path	String		Path
user	String		User Name
password	String		Password
async	Boolean		Initiate connection asyncronously
Function result	Longint		Error code result for the function

OP Start Remote Connection initiates a new remote connection using ARA on Macintosh or RAS on Windows NT or Windows 95.

The path parameter is the pathname to an ARA client document when using ARA, or a phonebook entry when using RAS. If the path parameter is passed as an empty string, a getfile prompts the user for the file (Macintosh). The user parameter is not implemented on ARA at this time. If the password parameter is passed as an empty string, OP Start Remote Connection uses the password stored in the file (if any).

Asynchronous:

   C_LONGINT(status1;$ErrCode;error)
   C_STRING(100;devType;devName)
   C_TEXT($errorText)

   $ErrCode:=OP Start Remote Connection("Home";"MyName";"MyPassword";True)

   Repeat
      $ErrCode:=OP Remote Connection Status(status1;error;devType;devName)
   Until(status#1) 

   $errorText:=OP Get Error Text($ErrCode)
   ...
   $errorText:=OP End Remote Connection()

Syncronous:

   $ErrCode:=OP Start Remote Connection("Home";"MyName";"MyPassword";False)
      `yields control back once connected or if error has occured

OP End Remote Connection, OP Remote Connection Status.