LInetHttp::Connect

#include "ltwrappr.h"

L_INT LInetHttp::Connect(pszServer, pszUserName = NULL, pszPassword = NULL, nPort = 80)

L_TCHAR *pszServer;

/* name of server to connect to */

L_TCHAR *pszUserName;

/* username for authentication */

L_TCHAR *pszPassword;

/* password for authentication */

L_INT nPort;

/* port number to connect to */

Connects to an HTTP server.

Parameter

Description

pszServer

Character string that contains the name of the server to which to connect. The name can be a network name, an IP address, or a domain name (www.leadtools.com).

pszUserName

Character string that contains the name of the user logging on. Default value is NULL. This is a NULL-terminated string.

pszPassword

Character string that contains the password to use when logging on. If both pszPassword and pszUsername are NULL, the connection is made anonymously.

nPort

Number of the port to which to connect. The default port assignment for web servers is 80.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

Use this function to establish a connection with an HTTP Server. To connect anonymously pass NULL for pszUserName and pszPassword.

A connection to an HTTP server must be established before using any other HTTP functions. If a connection is disconnected, via either LInetHttp::Disconnect or LInetHttp::~LInetHttp, then a connection must be re-established before any other HTTP functions are called. LInetHttp::Connect and LInetHttp::LInetHttp can be used to establish a connection with an HTTP server.

Required DLLs and Libraries

LTWEB

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application

See Also

Functions:

LInetHttp::LInetHttp, LInetHttp::Disconnect, LInetHttp::OpenRequest, LInetHttp::CloseRequest, LInetHttp::SendBitmap, LInetHttp::SendData, LInetHttp::SendForm, LInetHttp::SendRequest, LInetHttp::GetResponse, LInetHttp::GetServerStatus, Class Members

Topics:

HTTP Functions: Connect / Disconnect Operations

 

How to Program with the LInetHttp Class

Example

L_INT LInetHttp_ConnectExample(HWND hWndParent) 
{
   L_INT       nRet;
   LInetHttp   InetHttp(TEXT("www.leadtools.com"));
   // Checking if the connection failed
   nRet = InetHttp.GetErrorFromList ();
   if(nRet != SUCCESS)
   {
      InetHttp.DisplayError (hWndParent, TEXT("Can't connect to the HTTP web server"));
      return nRet; 
   }
   nRet = InetHttp.OpenRequest (HTTP_POST, TEXT("/default.htm"));
   if(nRet != SUCCESS)
   {
      InetHttp.DisplayError(hWndParent, TEXT("Can't open a request"));
      return nRet; 
   }
   // Another code
   InetHttp.CloseRequest ();
   InetHttp.Disconnect ();
   nRet = InetHttp.Connect(TEXT("www.leadtools.com"), TEXT("ABC"), TEXT("XYZ"));
   if(nRet != SUCCESS)
   {
      InetHttp.DisplayError (hWndParent, TEXT("Can't connect to the HTTP web server, user-name or password may invalid!!")); 
      return nRet; 
   }
   return SUCCESS;
}