CGopherFileFind, classe

Contribue à la recherche des fichiers Internet sur les serveurs Gopher.

Syntaxe

class CGopherFileFind : public CFileFind

Membres

Constructeurs publics

Méthodes publiques

Notes

CGopherFileFind inclut les fonctions membres qui commencent une recherche, recherchent un fichier et retournent l’URL d’un fichier.

D’autres classes MFC conçues pour internet et les fichiers locaux recherchés incluent CFtpFileFind et CFileFind. CGopherFileFindEnsemble, ces classes fournissent un mécanisme transparent permettant à l’utilisateur de rechercher des fichiers spécifiques, quel que soit le protocole de serveur, le type de fichier ou l’emplacement (un ordinateur local ou un serveur distant).) Notez qu’il n’existe aucune classe MFC pour la recherche sur les serveurs HTTP, car HTTP ne prend pas en charge la manipulation directe des fichiers requis par les recherches.

• GetRoot

• GetFileName

• GetFilePath

• GetFileTitle

• GetFileURL

En outre, lorsqu’elle est utilisée avec CGopherFileFind, la CFileFind fonction membre IsDots est toujours FALSE.

Pour plus d’informations sur l’utilisation CGopherFileFind et les autres classes WinInet, consultez l’article Programmation Internet avec WinInet.

Hiérarchie d'héritage

CObject

CFileFind

CGopherFileFind

Spécifications

En-tête : afxinet.h

CGopherFileFind ::CGopherFileFind

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

explicit CGopherFileFind(
    CGopherConnection* pConnection,
    DWORD_PTR dwContext = 1);

Paramètres

pConnection
Pointeur vers un objet CGopherConnection .

dwContext
Identificateur de contexte de l’opération. Pour plus d’informations sur dwContext, consultez Les remarques.

Notes

La valeur par défaut de dwContext est envoyée par MFC à l’objet CGopherFileFind à partir de l’objet CInternetSession qui a créé l’objet CGopherFileFind . Lorsque vous construisez un CGopherFileFind objet, vous pouvez remplacer la valeur par défaut pour définir l’identificateur de contexte sur une valeur de votre choix. L’identificateur de contexte est retourné à CInternetSession ::OnStatusCallback pour fournir l’état sur l’objet avec lequel il est identifié. Pour plus d’informations sur l’identificateur de contexte, consultez l’article Sur Internet First Steps : WinInet .

CGopherFileFind ::FindFile

Appelez cette fonction membre pour rechercher un fichier gopher.

virtual BOOL FindFile(
    CGopherLocator& refLocator,
    LPCTSTR pstrString,
    DWORD dwFlags = INTERNET_FLAG_RELOAD);

virtual BOOL FindFile(
    LPCTSTR pstrString,
    DWORD dwFlags = INTERNET_FLAG_RELOAD);

Paramètres

refLocator
Référence à un objet CGopherLocator .

pstrString
Pointeur vers une chaîne contenant le nom de fichier.

dwFlags
Indicateurs décrivant comment gérer cette session. Les indicateurs valides sont les suivants :

• INTERNET_FLAG_RELOAD obtenir les données du serveur distant, même si elles sont mises en cache localement.

• INTERNET_FLAG_DONT_CACHE Ne pas mettre en cache les données, localement ou dans toutes les passerelles.

• INTERNET_FLAG_SECURE Demander des transactions sécurisées sur le câble avec Secure Sockets Layer ou PCT. Cet indicateur s’applique uniquement aux requêtes HTTP.

• INTERNET_FLAG_USE_EXISTING Si possible, réutilisez les connexions existantes au serveur pour les nouvelles FindFile requêtes, au lieu de créer une nouvelle session pour chaque requête.

Valeur de retour

Valeur différente de zéro cas de réussite ; sinon, 0. Pour obtenir des informations d’erreur étendues, appelez la fonction Win32 GetLastError.

Notes

Après avoir appelé FindFile pour récupérer le premier objet gopher, vous pouvez appeler FindNextFile pour récupérer les fichiers gopher suivants.

CGopherFileFind ::FindNextFile

Appelez cette fonction membre pour poursuivre une recherche de fichiers commencée avec un appel à CGopherFileFind ::FindFile.

virtual BOOL FindNextFile();

Valeur de retour

Différent de zéro s’il y a plus de fichiers ; zéro si le fichier trouvé est le dernier dans le répertoire ou si une erreur s’est produite. Pour obtenir des informations d’erreur étendues, appelez la fonction Win32 GetLastError. Si le fichier trouvé est le dernier fichier du répertoire ou si aucun fichier correspondant n’est trouvé, la GetLastError fonction retourne ERROR_NO_MORE_FILES.

CGopherFileFind ::GetCreationTime

Obtient l’heure de création du fichier actif.

virtual BOOL GetCreationTime(FILETIME* pTimeStamp) const;
virtual BOOL GetCreationTime(CTime& refTime) const;

Paramètres

pTimeStamp
Pointeur vers une structure FILETIME contenant l’heure de création du fichier.

refTime
Référence à un objet CTime .

Valeur de retour

Différent de zéro s’il réussit ; 0 en cas d’échec. GetCreationTime renvoie 0 uniquement si FindNextFile n’a jamais été appelé sur cet CGopherFileFind objet.

Notes

Vous devez appeler FindNextFile au moins une fois avant d’appeler GetCreationTime.

CGopherFileFind ::GetLastAccessTime

Obtient l’heure à laquelle le fichier spécifié a été consulté pour la dernière fois.

virtual BOOL GetLastAccessTime(CTime& refTime) const;
virtual BOOL GetLastAccessTime(FILETIME* pTimeStamp) const;

Paramètres

refTime
Référence à un objet CTime .

pTimeStamp
Pointeur vers une structure FILETIME contenant l’heure à laquelle le fichier a été consulté pour la dernière fois.

Valeur de retour

Différent de zéro s’il réussit ; 0 en cas d’échec. GetLastAccessTime renvoie 0 uniquement si FindNextFile n’a jamais été appelé sur cet CGopherFileFind objet.

Notes

Vous devez appeler FindNextFile au moins une fois avant d’appeler GetLastAccessTime.

CGopherFileFind ::GetLastWriteTime

Obtient la dernière fois que le fichier a été modifié.

virtual BOOL GetLastWriteTime(FILETIME* pTimeStamp) const;
virtual BOOL GetLastWriteTime(CTime& refTime) const;

Paramètres

pTimeStamp
Pointeur vers une structure FILETIME contenant l’heure à laquelle le fichier a été écrit pour la dernière fois.

refTime
Référence à un objet CTime .

Valeur de retour

Différent de zéro s’il réussit ; 0 en cas d’échec. GetLastWriteTime renvoie 0 uniquement si FindNextFile n’a jamais été appelé sur cet CGopherFileFind objet.

Notes

Vous devez appeler FindNextFile au moins une fois avant d’appeler GetLastWriteTime.

CGopherFileFind ::GetLength

Appelez cette fonction membre pour obtenir la longueur, en octets, du fichier trouvé.

virtual ULONGLONG GetLength() const;

Valeur de retour

Longueur, en octets, du fichier trouvé.

Notes

GetLength utilise la structure Win32 WIN32_FIND_DATA pour obtenir la valeur de la taille du fichier en octets.

Exemple

Consultez l’exemple de CFile ::GetLength (implémentation de classe de base).

CGopherFileFind ::GetLocator

Appelez cette fonction membre pour obtenir l’objet CGopherLocator utilisé par FindFile pour rechercher le fichier gopher.

CGopherLocator GetLocator() const;

Valeur de retour

Objet CGopherLocator.

CGopherFileFind ::GetScreenName

Appelez cette fonction membre pour obtenir le nom de l’écran de chiffrement.

CString GetScreenName() const;

Valeur de retour

Nom de l’écran de chiffrement.

CGopherFileFind ::IsDots

Teste les marqueurs de répertoire actif et de répertoire parent lors de l’itération dans les fichiers.

virtual BOOL IsDots() const;

Valeur de retour

Différent de zéro si le fichier trouvé porte le nom « ». ou « ». », ce qui indique que le fichier trouvé est en fait un répertoire. Sinon, 0.

Notes

Vous devez appeler FindNextFile au moins une fois avant d’appeler IsDots.

Voir aussi

CFileFind, classe
Graphique hiérarchique
CFtpFileFind, classe
CFileFind, classe
CInternetFile, classe
CGopherFile, classe
CHttpFile, classe