CGopherConnection::CGopherConnection

Cette fonction membre est appelée pour construire un objet d' CGopherConnection .

CGopherConnection(
   CInternetSession* pSession,
   HINTERNET hConnected,
   LPCTSTR pstrServer,
   DWORD_PTR dwContext
);
CGopherConnection(
   CInternetSession* pSession,
   LPCTSTR pstrServer,
   LPCTSTR pstrUserName = NULL,
   LPCTSTR pstrPassword = NULL,
   DWORD_PTR dwContext = 0,
   INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER
);

Paramètres

• pSession
  Pointeur vers l'objet relatif de CInternetSession .

• hConnected
  Le handle de fenêtre de la session Internet.

• pstrServer
  Un pointeur vers une chaîne contenant le nom du serveur FTP.

• 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

• pstrUserName
  Pointeur vers une chaîne terminée par le caractère NULL qui spécifie le nom d'utilisateur pour ouvrir une session.Si NULL, la valeur par défaut est anonyme.

• pstrPassword
  Un pointeur vers une chaîne terminée par le caractère NULL qui spécifie le mot de passe à utiliser pour vous connecter.Si pstrPassword et pstrUserName sont NULL, le mot de passe anonyme par défaut est le nom de la messagerie électronique de l'utilisateur.Si pstrPassword est NULL (ou une chaîne vide) mais pstrUserName n'est pas NULL, les mots de passe vide sont utilisés.Le tableau suivant décrit le comportement des quatre paramètres possibles d' pstrUserName et d' pstrPassword:

  pstrUserName	pstrPassword	Nom d'utilisateur envoyé au serveur FTP	Mot de passe envoyée au serveur FTP
  NULL ou « «	NULL ou « «	« anonyme »	Nom de la messagerie électronique de l'utilisateur
  Chaîne non deNULL	NULL ou « «	pstrUserName	" "
  Chaîne non deNULLNULL	ERREUR	ERREUR
  Chaîne non deNULL	Chaîne non deNULL	pstrUserName	pstrPassword

• nPort
  Un nombre qui identifie le port de TCP/IP pour l'utiliser sur le serveur.

Notes

Vous ne créez jamais directement CGopherConnection .Au contraire, appelez CInternetSession::GetGopherConnection, qui crée un objet d' CGopherConnection et retourne un pointeur vers elle.

Configuration requise

Header: afxinet.h

Voir aussi

Référence

Classe de CGopherConnection

Graphique de la hiérarchie

Classe de CFtpConnection

Classe de CHttpConnection

Classe de CInternetConnection