CGopherLocator, classe

Obtient un « localisateur » gopher à partir d’un serveur gopher, détermine le type du localisateur et rend le localisateur disponible pour CGopherFileFind.

Remarque

Les classes CGopherConnection, , CGopherFile, CGopherLocatorCGopherFileFindet leurs membres ont été déconseillés parce qu’ils ne fonctionnent pas sur la plateforme Windows XP, mais ils continueront à travailler sur des plateformes antérieures.

Syntaxe

class CGopherLocator : public CObject

Membres

Constructeurs publics

Nom	Description
CGopherLocator ::CGopherLocator	Construit un objet CGopherLocator.

Méthodes publiques

Nom	Description
CGopherLocator ::GetLocatorType	Analyse un localisateur de chiffrement et détermine ses attributs.

Opérateurs publics

Nom	Description
CGopherLocator ::operator LPCTSTR	Accède directement aux caractères stockés dans un CGopherLocator objet sous forme de chaîne de style C.

Notes

Une application doit obtenir le localisateur d’un serveur gopher avant de pouvoir récupérer des informations à partir de ce serveur. Une fois qu’il a le localisateur, il doit traiter le localisateur comme un jeton opaque.

Chaque localisateur de chiffrement a des attributs qui déterminent le type de fichier ou de serveur trouvé. Consultez GetLocatorType pour obtenir la liste des types de localisateurs de gopher.

Une application utilise normalement le localisateur pour les appels à CGopherFileFind ::FindFile pour récupérer une information spécifique.

Pour en savoir plus sur CGopherLocator l’utilisation des autres classes Internet MFC, consultez l’article Programmation Internet avec WinInet.

Hiérarchie d'héritage

CObject

CGopherLocator

Spécifications

En-tête : afxinet.h

CGopherLocator ::CGopherLocator

Cette fonction membre est appelée pour créer un CGopherLocator objet.

CGopherLocator(const CGopherLocator& ref);

Paramètres

ref
Référence à un objet constant CGopherLocator .

Notes

Vous ne créez jamais d’objet CGopherLocator directement. Appelez plutôt CGopher Connecter ion ::CreateLocator pour créer et retourner un pointeur vers l’objetCGopherLocator.

CGopherLocator ::GetLocatorType

Appelez cette fonction membre pour obtenir le type de localisateur.

BOOL GetLocatorType(DWORD& dwRef) const;

Paramètres

dwRef
Référence à un DWORD qui recevra le type de localisateur. Consultez les remarques relatives à une table des types de localisateurs.

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.

Notes

Les types possibles sont les suivants :

Value	Signification
GOPHER_TYPE_TEXT_FILE	Fichier texte ASCII.
GOPHER_TYPE_DIRECTORY	Répertoire d’éléments Gopher supplémentaires.
GOPHER_TYPE_CSO	Un serveur de livres téléphoniques CSO.
GOPHER_TYPE_ERROR	Indique une condition d’erreur.
GOPHER_TYPE_MAC_BINHEX	Fichier Macintosh au format BINHEX.
GOPHER_TYPE_DOS_ARCHIVE	Fichier d’archivage DOS.
GOPHER_TYPE_UNIX_UUENCODED	Fichier UUENCODED.
GOPHER_TYPE_INDEX_SERVER	Un serveur d’index.
GOPHER_TYPE_TELNET	Un serveur Telnet.
GOPHER_TYPE_BINARY	Fichier binaire.
GOPHER_TYPE_REDUNDANT	Un serveur dupliqué. Les informations contenues dans ce serveur sont dupliquées du serveur principal. Le serveur principal est la dernière entrée de répertoire qui n’avait pas de type GOPHER_TYPE_REDUNDANT.
GOPHER_TYPE_TN3270	Un serveur TN3270.
GOPHER_TYPE_GIF	Fichier graphique GIF.
GOPHER_TYPE_IMAGE	Fichier image.
GOPHER_TYPE_BITMAP	Fichier bitmap.
GOPHER_TYPE_MOVIE	Un fichier vidéo.
GOPHER_TYPE_SOUND	Un fichier audio.
GOPHER_TYPE_HTML	Document HTML.
GOPHER_TYPE_PDF	Un fichier PDF.
GOPHER_TYPE_CALENDAR	Un fichier de calendrier.
GOPHER_TYPE_INLINE	Fichier inline.
GOPHER_TYPE_UNKNOWN	Le type d’élément est inconnu.
GOPHER_TYPE_ASK	Élément Ask+
GOPHER_TYPE_GOPHER_PLUS	Élément Gopher+.

CGopherLocator ::operator LPCTSTR

Cet opérateur de cast utile fournit une méthode efficace pour accéder à la chaîne C terminée par null contenue dans un CGopherLocator objet.

operator LPCTSTR () const;

Valeur de retour

Pointeur de caractères vers les données de la chaîne.

Notes

Aucun caractère n’est copié ; seul un pointeur est retourné.

Voir aussi

CObject, classe
Graphique hiérarchique
CGopherFileFind, classe