| INT Login( |
| |
LPCTSTR lpszUserName, |
|
| |
LPCTSTR lpszPassword, |
|
| |
LPCTSTR lpszAccount |
|
| ); |
The Login method authenticates the specified user in on the
server. This method must be called after the connection has
been established, and before attempting to transfer files or perform
any other method on the server.
Parameters
- lpszUserName
- Points to a string that specifies the user name
to be used to authenticate the current client session. If this
parameter is NULL or an empty string, then the login is considered
to be anonymous.
- lpszPassword
- Points to a string that specifies the password
to be used to authenticate the current client session. This
parameter may be NULL or an empty string if no password is required
for the specified user, or if no username has been specified.
- lpszAccount
- Points to a string that specifies the account
name to be used to authenticate the current client session. This
parameter may be NULL or an empty string if no account name is
required for the specified user.
Return Value
If the method succeeds, the return value is the server result
code. If the method fails, the return value is FTP_ERROR. To get
extended error information, call GetLastError.
Remarks
Some public FTP servers support anonymous logins, where a username
and password are not required to access the server. In this case,
both the lpszUserName and lpszPassword parameters can
be NULL or specify empty strings. In most cases, access to the server
using an anonymous login is restricted, with clients only having
permission to download files. Servers may also restrict the maximum
number of anonymous sessions that may be logged in at one time.
This method should only be used after calling the Logout method,
enabling you to log in as another user during the same session. Not
all servers will permit a client to change user credentials during the
same session. In most cases, it is preferable to disconnect from the
server and re-connect using the new credentials rather than using
this method.
This method is not supported with secure connections using the
SSH protocol.
Requirements
Minimum Desktop Platform: Windows 7 Service Pack 1
Minimum Server Platform: Windows Server 2008 R2 Service Pack 1
Header File: cstools11.h
Import Library: csftpv11.lib
Unicode: Implemented as Unicode and ANSI versions
See Also
Connect,
Logout,
ProxyConnect
|