Partager via


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, CGopherLocator CGopherFileFindet 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. Au lieu de cela, appelez CGopherConnection ::CreateLocator pour créer et renvoyer un pointeur vers l’objet CGopherLocator .

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 :

Valeur 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