CInternetSession::CInternetSession

CInternetSession (LPCTSTR pstrAgent = NULL, DWORD dwContext = 1, DWORD dwAccessType = INTERNET_OPEN_TYPE_PRECONFIG, type LPCTSTR pstrProxyName = NULL, LPCTSTR pstrProxyBypass = NULL, DWORD dwFlags = 0);

Paramètres

pstrAgent

Un pointeur vers une chaîne qui identifie le nom de l'application ou l'entité demandant les fonctions Internet (par exemple, "Microsoft Internet Browser"). Si pstrAgent est NULL (valeur par défaut), l'infrastructure appelle la fonction globale AfxGetAppName, qui retourne une chaîne contenant le nom d'une application. Certains protocoles utilisent cette chaîne pour identifier votre application sur le serveur.

dwContext

L'identificateur de contexte pour l'opération. dwContext identifie les informations d'État de l'opération retournées par CInternetSession::OnStatusCallback. La valeur par défaut est définie sur 1 ; Toutefois, vous pouvez affecter explicitement un ID de contexte pour l'opération. L'objet et aucun travail que sera associées à cet ID de contexte. Si dwFlags comprend les INTERNET_FLAG_ASYNC, les objets créés par cet objet ont comportement asynchrone comme une routine de rappel du statut est enregistrée. Dans l'ordre d'une fonction à remplir de façon synchrone, dwContext est fixée à zéro pour cet appel.

dwAccessType

Le type d'accès requis. Ce qui suit est des valeurs valides, exactement un qui peut être fourni:

• I&NTERNET_OPEN_TYPE_PRECONFIGnbsp ;  Préconfiguré (dans le registre). Ce type d'accès est défini comme la valeur par défaut.
  
  
• I&NTERNET_OPEN_TYPE_DIRECTnbsp ;  Direct à Internet.
  
  
• I&NTERNET_OPEN_TYPE_PROXYnbsp ;  Par le biais de proxy CERN.

pstrProxyName

Le nom du proxy CERN préféré si dwAccessType est défini comme INTERNET_OPEN_TYPE_PROXY. La valeur par défaut est NULL.

pstrProxyBypass

Un pointeur vers une chaîne contenant une liste facultative d'adresses de serveurs. Ces adresses peuvent être contournés lors de l'utilisation de l'accès proxy. Si une valeur NULL est fournie, on lira la liste de contournement du Registre. Ce paramètre n'a de sens que si dwAccessType est défini sur INTERNET_OPEN_TYPE_PROXY.

dwFlags

Indique les différentes options telles que mise en cache et asynchrone de comportement. La valeur par défaut est définie sur 0. Les valeurs possibles sont notamment:

• I&NTERNET_FLAG_DONT_CACHEnbsp ;  Pas en cache les données localement ou dans des serveurs de passerelle.
  
  
• I&NTERNET_FLAG_ASYNCnbsp ;  Les opérations futures sur cet objet peuvent échouer avec ERROR_IO_PENDING. Un rappel de la situation sera fait avec INTERNET_STATUS_REQUEST_COMPLETE lorsque l'opération se termine. Ce rappel est sur un thread autre que celui de la demande originale. Vous devez appeler EnableStatusCallback pour établir une routine de rappel du statut, ou les fonctions se termineront synchrone.
  
  
• I&NTERNET_FLAG_OFFLINEnbsp ;  Télécharger les opérations sont satisfaits par le cache persistant seulement. Si l'élément n'existe pas dans le cache, un code d'erreur approprié est retourné. Cet indicateur peut être combiné avec l'opérateur de bits OR (|).

Remarques

Cette fonction membre est appelée lorsqu'un objet CInternetSession est créé. CInternetSession est la première fonction d'Internet appelée par une application. Il initialise les structures de données internes et se prépare pour les futurs appels de l'application.

Si dwFlags comprend INTERNET_FLAG_ASYNC, puis tous les handles dérivées de cette poignée aura comportement asynchrone comme une routine de rappel du statut est enregistrée.

Si aucune connexion Internet ne peut être ouvert, CInternetSession lève un AfxThrowInternetException.

CInternetSession aperçu |nbsp ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;CInternetSession::Close, CInternetSession::EnableStatusCallback, CInternetSession::GetContext