CInternetSession::CInternetSession

Article
06/10/2015

Cette fonction membre est appelée lorsqu'un objet d' CInternetSession est créé.

CInternetSession( 
   LPCTSTR pstrAgent = NULL, 
   DWORD_PTR dwContext = 1, 
   DWORD dwAccessType = PRE_CONFIG_INTERNET_ACCESS, 
   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 de l'entité appelant Internet s'exécute (par exemple, « navigateur web Microsoft »). Si pstrAgent est NULL (valeur par défaut), l'infrastructure appelle la fonction globale AfxGetAppName, qui retourne une chaîne terminée par le caractère NULL contenant un nom d'application. Certains fournisseurs utilisent cette chaîne pour identifier votre application sur le serveur.
dwContext
l'identificateur de contexte pour l'exécution. dwContext identifie les informations d'état de l'opération retournées par CInternetSession::OnStatusCallback. La valeur par défaut est 1 ; toutefois, vous pouvez explicitement assigner un ID de contexte spécifique de l'exécution. L'objet et tout travail qu'il exécute sont associés à cet ID. de contexte
dwAccessType
Le type d'accès requis. Voici les valeurs valides, exactement l'un d'entre eux peut être fourni :
- INTERNET_OPEN_TYPE_PRECONFIG se connectent à l'aide de les paramètres préconfigurées dans le Registre. Ce type d'accès est défini comme valeur par défaut. Pour se connecter à un proxy de TIS, affectez dwAccessType à cette valeur ; vous définissez le Registre de manière appropriée.
- INTERNET_OPEN_TYPE_DIRECT se connectent directement à Internet.
- INTERNET_OPEN_TYPE_PROXY se connectent à un proxy de CERN.
Pour plus d'informations sur la connexion avec différents types de proxy, consultez l' Étapes dans une application cliente FTP classique.
pstrProxyName
Le nom de proxy par défaut de CERN 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 du serveur. Les adresses peuvent être sautées lors de l'accès de proxy. Si une valeur de NULL est fournie, la liste de contournement sera lue dans le Registre. Ce paramètre est pertinent uniquement si dwAccessType a la valeur INTERNET_OPEN_TYPE_PROXY.
dwFlags
Indique différentes options de mise en cache. La valeur par défaut est 0. Les valeurs possibles incluent :
- INTERNET_FLAG_DONT_CACHE ne mettent en cache les données, localement ou dans un aucun serveur de pont.
- Les opérations de téléchargement d'INTERNET_FLAG_OFFLINE sont satisfaites dans le cache persistant uniquement. Si l'élément n'existe pas dans le cache, le code d'erreur approprié est retourné. Cette balise peut être combiné avec de bits ( OR **|**Opérateur).

Notes

CInternetSession est la première fonction Internet appelée par une application. Il initialise les structures de données internes et se prépare à les futurs appels de l'application.

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