Partager via


CInternetSession::GetHttpConnection

Appelez la fonction membre pour établir une connexion HTTP et pour obtenir un pointeur vers un objet d' CHttpConnection .

CHttpConnection* GetHttpConnection( 
   LPCTSTR pstrServer, 
   INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER, 
   LPCTSTR pstrUserName = NULL, 
   LPCTSTR pstrPassword = NULL  
); 
CHttpConnection* GetHttpConnection( 
   LPCTSTR pstrServer, 
   DWORD dwFlags, 
   INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER, 
   LPCTSTR pstrUserName = NULL, 
   LPCTSTR pstrPassword = NULL  
);

Paramètres

  • pstrServer
    Un pointeur vers une chaîne contenant le nom du serveur HTTP.

  • nPort
    Un nombre qui identifie le port de TCP/IP pour l'utiliser sur le serveur.

  • pstrUserName
    Un pointeur vers une chaîne contenant le nom d'utilisateur.

  • pstrPassword
    Un pointeur vers une chaîne contenant le mot de passe d'accès.

  • dwflags
    Toute combinaison des balises d' INTERNET_ FLAG_* . Consultez le tableau dans la section de Notes de CHttpConnection::OpenRequest pour une description des valeurs d' dwFlags .

Valeur de retour

Un pointeur vers un objet de CHttpConnection . Si l'appel échoue, déterminez la cause de l'échec en examinant l'objet levé de CInternetException .

Notes

GetHttpConnection se connecte à un serveur HTTP, et crée et retourne un pointeur vers un objet d' CHttpConnection . Il n'effectue aucune opération spécifique sur le serveur. Si vous avez l'intention d'interroger un en-tête HTTP, par exemple, vous devez exécuter cette opération lors d'une étape distincte. Consultez les classes CHttpConnection et le CHttpFile pour plus d'informations sur les opérations que vous pouvez exécuter à l'aide d'une connexion à un serveur HTTP. Pour plus d'informations sur parcourir un site HTTP, consultez la fonction membre OpenURL. Consultez l'article Programmation avec Internet WinInet pour les étapes en effectuant les tâches courantes de connexion HTTP.

Exceptions

Cette méthode peut lever des exceptions de type CInternetException*.

Configuration requise

Header: afxinet.h

Voir aussi

Référence

CInternetSession, classe

Graphique de la hiérarchie

CHttpConnection, classe

CInternetSession::GetGopherConnection

CInternetSession::GetFtpConnection

CInternetSession::OpenURL