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
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;