The TelnetLogin function is used to authenticate a user,
logging them into the remote 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.