CInternetSession, classe

Article
06/10/2015

Crée et initialise les sessions unique ou plusieurs simultanées Internet et, si nécessaire, décrit la connexion à un serveur proxy.

class CInternetSession : public CObject

Membres

Constructeurs publics

Nom	Description
CInternetSession::CInternetSession	Construit un objet CInternetSession.

Méthodes publiques

Nom	Description
CInternetSession::Close	Ferme la connexion Internet lorsque la session d'Internet est terminée.
CInternetSession::EnableStatusCallback	Génère une routine de rappel d'état.
CInternetSession::GetContext	Ferme la connexion Internet lorsque la session d'Internet est terminée.
CInternetSession::GetCookie	Cookies de retour pour l'URL spécifiée et tous son parent URL.
CInternetSession::GetCookieLength	Extrait la variable spécifiant la longueur du cookie stocké dans la mémoire tampon.
CInternetSession::GetFtpConnection	Ouvre une session FTP avec un serveur. Se connecte l'utilisateur.
CInternetSession::GetGopherConnection	Ouvre un serveur Gopher pour une application essaie d'ouvrir une connexion.
CInternetSession::GetHttpConnection	Ouvre un serveur HTTP pour une application essaie d'ouvrir une connexion.
CInternetSession::OnStatusCallback	Met à jour l'état d'une exécution lorsque le rappel d'état est activé.
CInternetSession::OpenURL	Analyse et ouvre une URL.
CInternetSession::SetCookie	Définit un cookie pour l'URL spécifiée.
CInternetSession::SetOption	Définit des options pour la session d'Internet.

Opérateurs publics

Nom	Description
CInternetSession::operator HINTERNET	Un handle à la session active Internet.

Notes

Si votre connexion Internet doit être mise à jour pour la durée d'une application, vous pouvez créer un membre d' CInternetSession de la classe CWinApp.

Une fois que vous avez établi une connexion Internet, vous pouvez appeler OpenURL. CInternetSession analyse l'URL pour vous en appelant la fonction globale AfxParseURL. Indépendamment de son type de fournisseur, CInternetSession interprète l'URL et le gère automatiquement. Il peut traiter des demandes de fichiers locaux marqués avec la ressource « file:// » en URL. OpenURL retourne un pointeur vers un objet de CStdioFile si le nom que vous le passez est un fichier local.

Si vous ouvrez une URL sur un serveur Web à l'aide de OpenURL, vous pouvez lire les informations du site. Si vous souhaitez exécuter des actions de service particulier (par exemple, HTTP, FTP, ou Gopher) sur les fichiers situés sur un serveur, vous devez établir la connexion correcte avec ce serveur. Pour ouvrir un type particulier de connexion directement à un service particulier, utilisez l'une des fonctions membres suivantes :

GetGopherConnection pour ouvrir une pièce jointe à un service de Gopher.
GetHttpConnection pour ouvrir une pièce jointe à un service HTTP.
GetFtpConnection pour ouvrir une pièce jointe à un service FTP.

SetOption vous permet de définir les options de requête de votre session, telles que les valeurs du délai d'attente, numéro de relances, et ainsi de suite.

Les fonctions membres d'CInternetSessionSetCookie, GetCookie, et GetCookieLength fournissent les moyens de gérer une base de données de cookie Win32, via lequel les serveurs et les scripts mettent à jour les informations d'état à propos de la station de travail clientes.

Pour plus d'informations sur les tâches de base de programmation Internet, consultez l'article Premières étapes Internet : WinInet. Pour plus d'informations sur l'utilisation des classes WinInet MFC, consultez l'article Programmation avec Internet WinInet.

Notes

CInternetSession lève AfxThrowNotSupportedException pour les types de services non pris en charge.Seuls les types de services suivants sont actuellement pris en charge : FTP, HTTP, Gopher, puis fichier.