CGopherConnection::CreateLocator
Appelez la fonction membre pour créer un localisateur 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
Un pointeur vers une chaîne contenant le nom du document ou du dossier de Gopher à récupérer. Si le paramètre d' pstrDisplayString est NULL, le répertoire par défaut pour le serveur Gopher est retourné.pstrSelectorString
Un pointeur vers une chaîne de sélection à envoyer au serveur Gopher pour récupérer un élément. pstrSelectorString peut être NULL.dwGopherType
Spécifie si pstrSelectorString fait référence à un dossier ou un document, et si la demande est Gopher ou gopher+. Consultez les attributs de la structure GOPHER_FIND_DATA dans Kit de développement logiciel Windows.pstrLocator
Un pointeur vers une chaîne identifiant le fichier à ouvrir. En général, cette chaîne est retournée à partir d'un appel à CGopherFileFind::GetLocator.pstrServerName
Un pointeur vers une chaîne contenant le nom du serveur Gopher.nPort
Le nombre identificateur le port Internet pour cette connexion.
Valeur de retour
Un objet de CGopherLocator .
Notes
La version statique de la fonction membre requiert que vous spécifiiez un serveur, alors que la version non statique utilise le nom du serveur de l'objet de Connexion.
Pour récupérer des informations d'un serveur Gopher, une application doit d'abord obtenir un localisateur de Gopher. L'application doit ensuite traiter le localisateur comme jeton opaque (autrement dit, l'application peut utiliser le localisateur mais pas directement le manipuler ou comparer). Normalement, l'application utilise le localisateur pour les appels à la fonction membre de CGopherFileFind::FindFile pour récupérer une information spécifique.
Configuration requise
Header: afxinet.h