The TelnetLogin function is used to authenticate a user,
logging them into the server. This function is specifically
designed to work with most UNIX based servers, and may work with
other servers that use a similar login process. The function works by
scanning the data stream for a username prompt and then replying with
the specified username. If that is successful, it will then scan for
a password prompt and provide the specified password. If no
recognized prompt is found, or if the server responds with an error
indicating that the username or password is invalid, the function
will fail.
If the TelnetLogin function succeeds, the next call to
TelnetRead by the client will return any welcome message to
the user. This is typically followed by a command prompt where the
user can enter commands to be executed on the server. The data sent
by the server during the login process is discarded and not available
when the function returns. If the client requires this information,
use the TelnetSearch function to automate the login process
instead.
Because the TelnetLogin function is designed for UNIX based
systems, it may not work with servers running on other operating
system platforms such as Windows or VMS. In this case, applications
should use the TelnetSearch function to search for the
appropriate login prompts in the data stream.