|
|
Login to the remote server.
Syntax
object.Login( [UserName],
[Password], [Account] )
Remarks
The Login method identifies the user to the remote
server. If the user name or password is invalid, an error will
occur. By default, when a connection is established, the
UserName, Password and Account properties are
used to automatically log the user in to the server. This method is
typically used if you wish to log in as another user during the
same session.
- UserName
- A string that specifies the name of the user logging into the
server. This argument is optional, and if it is omitted, the value
of the UserName property will be used. If the
UserName property has not been set, an anonymous user
session is established.
- Password
- A string that specifies the password used to authenticate the
user. This argument is optional, and if it is omitted, the value of
the Password property will be used. If no user name has been
specified, then an anonymous user session is established; in this
case, the common convention that is used is that the password is
specified as the current user's email address.
- Account
- A string that specifies the account name to be used when
authenticating the user. This argument is optional, and if omitted,
the value of the Account property will be used. An account
name should only be specified if required by the server. Most UNIX
and Windows based FTP servers do not require an account name.
Return Value
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.
See Also
Account
Property, Password
Property, UserName
Property, Connect Method, Logout Method
|
|