Share via


CHttpConnection::CHttpConnection

This member function is called to construct a CHttpConnection object.

CHttpConnection( 
   CInternetSession* pSession, 
   HINTERNET hConnected, 
   LPCTSTR pstrServer, 
   DWORD_PTR dwContext 
); 
CHttpConnection( 
   CInternetSession* pSession, 
   LPCTSTR pstrServer, 
   INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER, 
   LPCTSTR pstrUserName = NULL, 
   LPCTSTR pstrPassword = NULL, 
   DWORD_PTR dwContext = 1 
); 
CHttpConnection( 
   CInternetSession* pSession, 
   LPCTSTR pstrServer, 
   DWORD dwFlags, 
   INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER, 
   LPCTSTR pstrUserName = NULL, 
   LPCTSTR pstrPassword = NULL, 
   DWORD_PTR dwContext = 1 
);

Parameters

  • pSession
    A pointer to a CInternetSession object.

  • hConnected
    A handle to an Internet connection.

  • pstrServer
    A pointer to a string containing the server name.

  • dwContext
    The context identifier for the CInternetConnection object. See Remarks for more information about dwContext.

  • nPort
    The number that identifies the Internet port for this connection.

  • pstrUserName
    Pointer to a null-terminated string that specifies the name of the user to log in. If NULL, the default is anonymous.

  • pstrPassword
    A pointer to a null-terminated string that specifies the password to use to log in. If both pstrPassword and pstrUserName are NULL, the default anonymous password is the user's email name. If pstrPassword is NULL (or an empty string) but pstrUserName is not NULL, a blank password is used. The following table describes the behavior for the four possible settings of pstrUserName and pstrPassword:

    pstrUserName

    pstrPassword

    Username sent to FTP server

    Password sent to FTP server

    NULL or " "

    NULL or " "

    "anonymous"

    User's email name

    Non-NULL String

    NULL or " "

    pstrUserName

    " "

    NULL Non-NULL String

    ERROR

    ERROR

     

    Non-NULL String

    Non-NULL String

    pstrUserName

    pstrPassword

  • dwFlags
    Any combination of the INTERNET_ FLAG_* flags. See the table in the Remarks section of CHttpConnection::OpenRequest for a description of dwFlags values.

Remarks

You never create a CHttpConnection directly. Rather, you create an object by calling CInternetSession::GetHttpConnection.

Requirements

Header: afxinet.h

See Also

Reference

CHttpConnection Class

Hierarchy Chart

CInternetSession::GetHttpConnection

CFtpConnection Class

CGopherConnection Class

CInternetConnection Class

Other Resources

CHttpConnection Members