Share via

CInternetConnection, classe

  • Article

Gère votre connexion à un serveur Internet.

Syntaxe

class CInternetConnection : public CObject

Membres

Constructeurs publics

Nom Description
CInternet Connecter ion ::CInternet Connecter ion Construit un objet CInternetConnection.

Méthodes publiques

Nom Description
CInternet Connecter ion ::GetContext Obtient l’ID de contexte de cet objet de connexion.
CInternet Connecter ion ::GetServerName Obtient le nom du serveur associé à la connexion.
CInternet Connecter ion ::GetSession Obtient un pointeur vers l’objet CInternetSession associé à la connexion.

Opérateurs publics

Nom Description
CInternet Connecter ion ::operator HINTERNET Handle vers une session Internet.

Notes

Il s’agit de la classe de base pour les classes MFC CFtp Connecter ion, CHttp Connecter ion et CGopher Connecter ion. Chacune de ces classes fournit des fonctionnalités supplémentaires pour communiquer avec le serveur FTP, HTTP ou gopher respectif.

Pour communiquer directement avec un serveur Internet, vous devez disposer d’un objet CInternetSession et d’un CInternetConnection objet.

Pour en savoir plus sur le fonctionnement des classes WinInet, consultez l’article Programmation Internet avec WinInet.

Hiérarchie d'héritage

CObject

CInternetConnection

Spécifications

En-tête : afxinet.h

CInternet Connecter ion ::CInternet Connecter ion

Cette fonction membre est appelée lorsqu’un CInternetConnection objet est créé.

CInternetConnection(
    CInternetSession* pSession,
    LPCTSTR pstrServer,
    INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER,
    DWORD_PTR dwContext = 1);

Paramètres

pSession
Pointeur vers un objet CInternetSession .

pstrServer
Pointeur vers une chaîne contenant le nom du serveur.

nPort
Numéro qui identifie le port Internet pour cette connexion.

dwContext
Identificateur de contexte de l’objet CInternetConnection . Pour plus d’informations sur dwContext, consultez Les remarques.

Notes

Vous n’appelez CInternetConnection jamais vous-même ; appelez plutôt la fonction membre CInternetSession pour le type de connexion que vous souhaitez établir :

La valeur par défaut de dwContext est envoyée par MFC à l’objet dérivé de L’objet CInternetConnectionCInternetSession qui a créé l’objet dérivé d’Internet Connecter ion. La valeur par défaut est 1 ; Toutefois, vous pouvez attribuer explicitement un identificateur de contexte spécifique dans le constructeur CInternetSession pour la connexion. L’objet et tout travail qu’il effectue sera associé à cet ID de contexte. L’identificateur de contexte est retourné à CInternetSession ::OnStatusCallback pour fournir l’état sur l’objet avec lequel il est identifié. Pour plus d’informations sur l’identificateur de contexte, consultez l’article Sur Internet First Steps : WinInet .

CInternet Connecter ion ::GetContext

Appelez cette fonction membre pour obtenir l’ID de contexte de cette session.

DWORD_PTR GetContext() const;

Valeur de retour

ID de contexte affecté par l’application.

Notes

L’ID de contexte est initialement spécifié dans CInternetSession et se propage aux CInternetConnectionclasses dérivées de CInternetFile, sauf indication différente dans l’appel à une fonction qui ouvre la connexion. L’ID de contexte est associé à n’importe quelle opération de l’objet donné et identifie les informations d’état de l’opération retournées par CInternetSession ::OnStatusCallback.

Pour plus d’informations sur GetContext l’utilisation d’autres classes WinInet pour fournir des informations d’état utilisateur, consultez l’article Internet First Steps : WinInet pour plus d’informations sur l’identificateur de contexte.

CInternet Connecter ion ::GetServerName

Appelez cette fonction membre pour obtenir le nom du serveur associé à cette connexion Internet.

CString GetServerName() const;

Valeur de retour

Nom du serveur avec lequel cet objet de connexion fonctionne.

CInternet Connecter ion ::GetSession

Appelez cette fonction membre pour obtenir un pointeur vers l’objet CInternetSession associé à cette connexion.

CInternetSession* GetSession() const;

Valeur de retour

Pointeur vers un objet CInternetSession associé à cet objet de connexion Internet.

CInternet Connecter ion ::operator HINTERNET

Utilisez cet opérateur pour obtenir le handle au niveau de l’API pour la session Internet actuelle.

operator HINTERNET() const;

Voir aussi

CObject, classe
Graphique hiérarchique