:GetFileLength()


Class

     aprFTP()

 

Syntax

     :GetFileLength( cFilename, [hSession] ) -> nBytes

 

Parameters

 

cFilename

Name of the file on the remote server.

 

hSession

Optional: If hSession is not passed, the value in :Session will be used

 

Return

Size of file on the remote server.

If the operation fails, the return value will be zero.

 

To get further error information see :nErr and :cErr

To see the remote server's response, see :GetResultCode() and :GetResultString().

 

Description

The :GetFileLength() method returns the length of the specified file on the remote server.

 

This method uses the SIZE command to determine the length of the specified file.

Not all servers implement this command, in which case the call will fail, and the return value will be zero.

 

See Also

:GetFileStatus(), :OpenDirectory()