Transfers data from a file on the server and store it in a local
object.GetData( RemoteFile, Buffer,
[Length], [Reserved] )
- A string that specifies the file on the server that will
be transferred to the local system. The file pathing and name
conventions must be that of the server.
- This parameter specifies the local buffer that the data will be
stored in. If the variable is a String type, then the data will be
returned as a string of characters. This is the most appropriate
data type to use if the file on the server is a text file. If the remote
file contains binary data, it is recommended that a Byte array
variable be specified as the argument to this method.
- An optional integer argument that will contain the number of
bytes copied into the buffer when the method returns.
- An argument reserved for future expansion. This argument should
always be omitted or specified as a numeric value of zero.
A value of zero is returned if the operation was successful,
otherwise a non-zero error code is returned which indicates the cause
of the failure.
The GetData method transfers data from a file on the server
to the local system, storing it in the specified buffer . This method
will cause the current thread to block until the file transfer
completes, a timeout occurs or the transfer is canceled. During the
transfer, the OnProgress event will fire periodically,
enabling the application to update any user interface objects such as
a progress bar.