Partager via


CInternetConnection, classe

Gère votre connexion à un serveur Internet.

Syntaxe

class CInternetConnection : public CObject

Membres

Constructeurs publics

Nom Description
CInternetConnection ::CInternetConnection Construit un objet CInternetConnection.

Méthodes publiques

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

Opérateurs publics

Nom Description
CInternetConnection ::operator HINTERNET Handle vers une session Internet.

Notes

Il s’agit de la classe de base pour les classes MFC CFtpConnection, CHttpConnection et CGopherConnection. 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

CInternetConnection ::CInternetConnection

Cette fonction membre est appelée lorsqu’un objet CInternetConnection 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’InternetConnection. 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 .

CInternetConnection ::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.

CInternetConnection ::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.

CInternetConnection ::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.

CInternetConnection ::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