CGopherConnection, classe

Gère votre connexion à un serveur Internet Gopher.

Syntaxe

class CGopherConnection : public CInternetConnection

Membres

Constructeurs publics

Méthodes publiques

Notes

Le service gopher est l’un des trois services Internet reconnus par les classes WinInet MFC.

La classe CGopherConnection contient un constructeur et trois fonctions membres supplémentaires qui gèrent le service gopher : OpenFile, CreateLocator et GetAttribute.

Pour communiquer avec un serveur Internet gopher, vous devez d’abord créer une instance de CInternetSession, puis appeler CInternetSession ::GetGopherConnection, qui crée l’objet CGopherConnection et retourne un pointeur vers celui-ci. Vous ne créez jamais d’objet CGopherConnection directement.

Pour en savoir plus sur CGopherConnection l’utilisation des autres classes Internet MFC, consultez l’article Programmation Internet avec WinInet. Pour plus d’informations sur l’utilisation des deux autres services Internet pris en charge, FTP et HTTP, consultez les classes CHttpConnection et CFtpConnection.

Hiérarchie d'héritage

CObject

CInternetConnection

CGopherConnection

Spécifications

En-tête : afxinet.h

CGopherConnection ::CGopherConnection

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

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 CInternetSession associé.

hConnected
Handle Windows de la session Internet active.

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

dwContext
Identificateur de contexte de l’opération. dwContext identifie les informations d’état de l’opération retournées par CInternetSession ::OnStatusCallback. La valeur par défaut est 1, mais vous pouvez affecter explicitement un ID de contexte spécifique pour l’opération. L’objet et tout travail qu’il effectue sera associé à cet ID de contexte.

pstrUserName
Pointeur vers une chaîne terminée par null qui spécifie le nom d’utilisateur pour se connecter. Si la valeur est NULL, la valeur par défaut est anonyme.

pstrPassword
Pointeur vers une chaîne terminée par null qui spécifie le mot de passe à utiliser pour se connecter. Si pstrPassword et pstrUserName sont NULL, le mot de passe anonyme par défaut est le nom de messagerie de l’utilisateur. Si pstrPassword a la valeur NULL (ou une chaîne vide), mais pstrUserName n’est pas NULL, un mot de passe vide est utilisé. Le tableau suivant décrit le comportement des quatre paramètres possibles de pstrUserName et pstrPassword :

nPort
Nombre qui identifie le port TCP/IP à utiliser sur le serveur.

Notes

Vous ne créez jamais directement.CGopherConnection Appelez plutôt CInternetSession ::GetGopherConnection, qui crée un CGopherConnection objet et retourne un pointeur vers celui-ci.

CGopherConnection ::CreateLocator

Appelez cette fonction membre pour créer un localisateur de chiffrement de gopher pour rechercher ou identifier un fichier sur un serveur gopher.

CGopherLocator CreateLocator(
    LPCTSTR pstrDisplayString,
    LPCTSTR pstrSelectorString,
    DWORD dwGopherType);

static CGopherLocator CreateLocator(LPCTSTR pstrLocator);

static CGopherLocator CreateLocator(
    LPCTSTR pstrServerName,
    LPCTSTR pstrDisplayString,
    LPCTSTR pstrSelectorString,
    DWORD dwGopherType,
    INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER);

Paramètres

pstrDisplayString
Pointeur vers une chaîne contenant le nom du document ou du répertoire gopher à récupérer. Si le paramètre pstrDisplayString a la valeur NULL, le répertoire par défaut du serveur gopher est retourné.

pstrSelectorString
Pointeur vers la chaîne de sélecteur à envoyer au serveur gopher afin de récupérer un élément. pstrSelectorString peut être NULL.

dwGopherType
Cela spécifie si pstrSelectorString fait référence à un répertoire ou à un document, et si la requête est gopher ou gopher+. Consultez les attributs de la structure GOPHER_FIND_DATA dans le Kit de développement logiciel (SDK) Windows.

pstrLocator
Pointeur vers une chaîne identifiant le fichier à ouvrir. En règle générale, cette chaîne est retournée à partir d’un appel à CGopherFileFind ::GetLocator.

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

nPort
Numéro identifiant le port Internet pour cette connexion.

Valeur de retour

Objet CGopherLocator .

Notes

La version statique de la fonction membre vous oblige à spécifier un serveur, tandis que la version non statique utilise le nom du serveur à partir de l’objet de connexion.

Pour récupérer des informations à partir d’un serveur gopher, une application doit d’abord obtenir un localisateur de chiffrement. L’application doit ensuite traiter le localisateur comme un jeton opaque (autrement dit, l’application peut utiliser le localisateur, mais pas manipuler ou comparer directement). Normalement, l’application utilise le localisateur pour les appels à la fonction membre CGopherFileFind ::FindFile pour récupérer une information spécifique.

CGopherConnection ::GetAttribute

Appelez cette fonction membre pour récupérer des informations d’attribut spécifiques sur un élément à partir du serveur gopher.

BOOL GetAttribute(
    CGopherLocator& refLocator    CString strRequestedAttributes,
    CString& strResult,);

Paramètres

refLocator
Référence à un objet CGopherLocator .

strRequestedAttributes
Chaîne délimitée par un espace spécifiant les noms des attributs demandés.

strResult
Référence à un CString qui reçoit le type de localisateur.

Valeur de retour

Valeur différente de zéro cas de réussite ; sinon, 0. Si l’appel échoue, la fonction Win32 GetLastError peut être appelée pour déterminer la cause de l’erreur.

CGopherConnection ::OpenFile

Appelez cette fonction membre pour ouvrir un fichier sur un serveur gopher.

CGopherFile* OpenFile(
    CGopherLocator& refLocator,
    DWORD dwFlags = 0,
    LPCTSTR pstrView = NULL,
    DWORD_PTR dwContext = 1);

Paramètres

refLocator
Référence à un objet CGopherLocator .

dwFlags
Toute combinaison d’indicateurs INTERNET_FLAG_*. Consultez CInternetSession ::OpenUrl pour plus d’informations sur les indicateurs INTERNET_FLAG_*.

pstrView
Pointeur vers une chaîne d’affichage de fichier. Si plusieurs vues du fichier existent sur le serveur, ce paramètre spécifie la vue de fichier à ouvrir. Si pstrView a la valeur NULL, la vue de fichier par défaut est utilisée.

dwContext
ID de contexte du fichier en cours d’ouverture. Pour plus d’informations sur dwContext, consultez Les remarques.

Valeur de retour

Pointeur vers l’objet CGopherFile à ouvrir.

Notes

Remplacez la valeur par défaut dwContext pour définir l’identificateur de contexte sur une valeur de votre choix. L’identificateur de contexte est associé à cette opération spécifique de l’objet CGopherConnection créé par son objet CInternetSession . La valeur est retournée à CInternetSession ::OnStatusCallback pour fournir l’état de l’opération avec laquelle elle est identifiée. Pour plus d’informations sur l’identificateur de contexte, consultez l’article Sur Internet First Steps : WinInet .

Voir aussi

CInternetConnection, classe
Graphique hiérarchique
CFtpConnection, classe
CHttpConnection, classe
CInternetConnection, classe
CGopherLocator, classe
CGopherFile, classe
CInternetSession, classe