Utilisez la classe CInternetSession pour créer et initialiser une seule ou plusieurs sessions simultanées de l'Internet et, si nécessaire, de décrire votre connexion à un serveur proxy. Si votre connexion Internet doit être maintenue pendant toute la durée de la demande, vous pouvez créer un membre CInternetSession de la classe CWinApp.
Une fois que vous avez établi une session Internet, vous pouvez appeler OpenURL. CInternetSession analyse ensuite l'URL pour vous en appelant la fonction globale AfxParseURL. Indépendamment de son type de protocole, CInternetSession interprète l'URL et il gère pour vous. Il peut traiter les demandes de fichiers locaux, identifiées par la ressource URL « file:// ». OpenURL retourne un pointeur vers un objet CStdioFile si le nom que vous lui passez un fichier local.
Si vous ouvrez une URL sur un serveur Internet à l'aide d'OpenURL, vous pouvez lire des informations sur le site. Si vous souhaitez effectuer des actions de service spécifique (par exemple, HTTP, FTP et gopher) sur les fichiers situés sur un serveur, vous devez établir la connexion appropriée avec ce serveur. Pour ouvrir un type particulier de connexion directement à un service particulier, utilisez l'une des fonctions membres:
QueryOption et SetOption vous permettent de définir les options de requête de votre session, comme les valeurs de délai d'attente, le nombre de tentatives et ainsi de suite.
Les fonctions de membre CInternetSession SetCookieet GetCookie GetCookieLength fournissent les moyens de gérer une base de données Win32 cookie, à travers lequel scripts et serveurs maintiennent des informations d'État sur le poste client.
Lors d'une session Internet, une opération comme un téléchargement de données ou de la recherche peut prendre un temps appréciable. L'utilisateur pourrait veulent continuer à travailler, ou souhaitez avoir des informations sur l'état de l'avancement de l'opération. Pour gérer ce problème, CInternetSession fournit pour le transfert de données et recherches de se produire asychronously, permettant à l'utilisateur d'effectuer d'autres tâches en attendant le transfert à remplir. Si vous souhaitez fournir à l'utilisateur avec des informations d'État, ou si vous souhaitez gérer toutes les opérations de façon asynchrone, trois conditions doivent être définies:
Utilisez la fonction de membre overridable OnStatusCallback pour obtenir des informations sur l'état de récupération asynchrone. Pour utiliser cette fonction de membres overridable, vous devez dériver votre propre classe de CInternetSession.
Pour plus d'informations sur les opérations asynchrones, consultez l'article premiers pas Internet : WinInet dans le Guide du programmeur Visual C++. Pour des informations générales sur l'utilisation de classes WinInet MFC, consultez l'article Internet programmation avec WinInet dans le Guide du programmeur Visual C++.
&Notenbsp ;CInternetSession lèvera une AfxThrowNotSupportedException pour les types de service non pris en charge. Seuls les types de service suivants sont actuellement pris en charge: FTP, HTTP, gopher et fichier.
# include lt;afxinet.h>
Membres de la classe |nbsp ; Classe de base | Graphique de la hiérarchie
Écha&ntillons denbsp ; Exemple MFC FTPTREE | Exemple MFC TEAR
Voir aussi ;CInternetConnection, CHttpConnection, CFtpConnection, CGopherConnection