CGopherFileFind, classe
Contribue à la recherche des fichiers Internet sur les serveurs Gopher.
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 CGopherFileFind : public CFileFind
Membres
Constructeurs publics
| Nom | Description |
|---|---|
| CGopherFileFind ::CGopherFileFind | Construit un objet CGopherFileFind. |
Méthodes publiques
| Nom | Description |
|---|---|
| CGopherFileFind ::FindFile | Recherche un fichier sur un serveur gopher. |
| CGopherFileFind ::FindNextFile | Poursuit une recherche de fichiers à partir d’un appel précédent à FindFile. |
| CGopherFileFind ::GetCreationTime | Obtient l’heure de création du fichier spécifié. |
| CGopherFileFind ::GetLastAccessTime | Obtient l’heure à laquelle le fichier spécifié a été consulté pour la dernière fois. |
| CGopherFileFind ::GetLastWriteTime | Obtient l’heure à laquelle le fichier spécifié a été écrit pour la dernière fois. |
| CGopherFileFind ::GetLength | Obtient la longueur du fichier trouvé, en octets. |
| CGopherFileFind ::GetLocator | Obtenir un CGopherLocator objet. |
| CGopherFileFind ::GetScreenName | Obtient le nom d’un é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. |
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.
Remarque
CGopherFileFind ne prend pas en charge les fonctions membres suivantes de sa classe de base CFileFind :
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
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 CGopher Connecter ion.
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
FindFilerequê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.
Remarque
Tous les systèmes de fichiers n’utilisent pas la même sémantique pour implémenter l’horodatage retourné par cette fonction. Cette fonction peut retourner la même valeur retournée par d’autres fonctions d’horodatage si le système de fichiers ou le serveur sous-jacent ne prend pas en charge la conservation de l’attribut de temps. Consultez la structure WIN32_FIND_DATA pour plus d’informations sur les formats de temps. Sur certains systèmes d’exploitation, l’heure retournée se trouve dans le fuseau horaire local de l’ordinateur, car le fichier se trouve. Pour plus d’informations, consultez l’API Win32 FileTimeToLocalFileTime .
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.
Remarque
Tous les systèmes de fichiers n’utilisent pas la même sémantique pour implémenter l’horodatage retourné par cette fonction. Cette fonction peut retourner la même valeur retournée par d’autres fonctions d’horodatage si le système de fichiers ou le serveur sous-jacent ne prend pas en charge la conservation de l’attribut de temps. Consultez la structure WIN32_FIND_DATA pour plus d’informations sur les formats de temps. Sur certains systèmes d’exploitation, l’heure retournée se trouve dans le fuseau horaire local de l’ordinateur, car le fichier se trouve. Pour plus d’informations, consultez l’API Win32 FileTimeToLocalFileTime .
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.
Remarque
Tous les systèmes de fichiers n’utilisent pas la même sémantique pour implémenter l’horodatage retourné par cette fonction. Cette fonction peut retourner la même valeur retournée par d’autres fonctions d’horodatage si le système de fichiers ou le serveur sous-jacent ne prend pas en charge la conservation de l’attribut de temps. Consultez la structure WIN32_FIND_DATA pour plus d’informations sur les formats de temps. Sur certains systèmes d’exploitation, l’heure retournée se trouve dans le fuseau horaire local de l’ordinateur, car le fichier se trouve. Pour plus d’informations, consultez l’API Win32 FileTimeToLocalFileTime .
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.
Remarque
À partir de MFC 7.0, GetLength prend en charge les types entiers 64 bits. Le code créé précédemment avec cette version plus récente de la bibliothèque peut entraîner des avertissements de troncation.
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
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour