CGopherFileFind-Klasse

  • Artikel

Unterstützt die Internetsuche nach Dateien auf Gopherservern.

Hinweis

Die Klassen CGopherConnection, CGopherFile, und CGopherLocatorCGopherFileFindihre Member sind veraltet, da sie nicht auf der Windows XP-Plattform funktionieren, aber sie arbeiten weiterhin auf früheren Plattformen.

Syntax

class CGopherFileFind : public CFileFind

Member

Öffentliche Konstruktoren

Name Beschreibung
CGopherFileFind::CGopherFileFind Erstellt ein CGopherFileFind-Objekt.

Öffentliche Methoden

Name Beschreibung
CGopherFileFind::FindFile Sucht eine Datei auf einem Gopherserver.
CGopherFileFind::FindNextFile Setzt eine Dateisuche aus einem vorherigen Aufruf von FindFile fort.
CGopherFileFind::GetCreationTime Ruft die Zeit ab, zu der die angegebene Datei erstellt wurde.
CGopherFileFind::GetLastAccessTime Ruft die Zeit ab, zu der die angegebene Datei zuletzt zugegriffen wurde.
CGopherFileFind::GetLastWriteTime Ruft die Zeit ab, in die die angegebene Datei zuletzt geschrieben wurde.
CGopherFileFind::GetLength Ruft die Länge der gefundenen Datei in Bytes ab.
CGopherFileFind::GetLocator Ruft ein CGopherLocator Objekt ab.
CGopherFileFind::GetScreenName Ruft den Namen eines Gopher-Bildschirms ab.
CGopherFileFind::IsDots Testet beim Durchlaufen von Dateien auf die aktuellen Verzeichnis- und übergeordneten Verzeichnismarkierungen.

Hinweise

CGopherFileFind enthält Memberfunktionen, die eine Suche beginnen, eine Datei suchen und die URL einer Datei zurückgeben.

Andere MFC-Klassen, die für internet- und lokale Dateien durchsucht wurden, sind CFtpFileFind und CFileFind. Zusammen mit CGopherFileFinddiesen Klassen bietet der Benutzer einen nahtlosen Mechanismus, um bestimmte Dateien zu finden, unabhängig vom Serverprotokoll, Dateityp oder Speicherort (entweder ein lokaler Computer oder ein Remoteserver).) Beachten Sie, dass es keine MFC-Klasse für die Suche auf HTTP-Servern gibt, da HTTP die direkte Dateibearbeitung, die von Suchvorgängen benötigt wird, nicht unterstützt.

Hinweis

CGopherFileFind unterstützt nicht die folgenden Memberfunktionen der Basisklasse CFileFind:

Darüber hinaus ist bei Verwendung mit CGopherFileFindder CFileFind Memberfunktion IsDots immer FALSE.

Weitere Informationen zur Verwendung CGopherFileFind und zu den anderen WinInet-Klassen finden Sie im Artikel "Internet Programming with WinInet".

Vererbungshierarchie

CObject

CFileFind

CGopherFileFind

Anforderungen

Kopfzeile: afxinet.h

CGopherFileFind::CGopherFileFind

Diese Memberfunktion wird aufgerufen, um ein CGopherFileFind Objekt zu erstellen.

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

Parameter

pConnection
Ein Zeiger auf ein CGopher Verbinden ion-Objekt.

dwContext
Der Kontextbezeichner für den -Vorgang. Weitere Informationen zu dwContext finden Sie in den Hinweisen.

Hinweise

Der Standardwert für dwContext wird von MFC an das CGopherFileFind Objekt aus dem CInternetSession-Objekt gesendet, das das CGopherFileFind Objekt erstellt hat. Wenn Sie ein CGopherFileFind Objekt erstellen, können Sie den Standardwert überschreiben, um den Kontextbezeichner auf einen Wert Ihrer Wahl festzulegen. Der Kontextbezeichner wird an CInternetSession::OnStatusCallback zurückgegeben, um den Status des Objekts bereitzustellen, mit dem es identifiziert wird. Weitere Informationen zum Kontextbezeichner finden Sie im Artikel "Internet First Steps: WinInet ".

CGopherFileFind::FindFile

Rufen Sie diese Memberfunktion auf, um eine Gopherdatei zu finden.

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

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

Parameter

refLocator
Ein Verweis auf ein CGopherLocator-Objekt .

pstrString
Ein Zeiger auf eine Zeichenfolge, die den Dateinamen enthält.

dwFlags
Die Flags, die beschreiben, wie diese Sitzung behandelt wird. Die gültigen Flags sind:

  • INTERNET_FLAG_RELOAD Abrufen der Daten vom Remoteserver selbst dann, wenn sie lokal zwischengespeichert wird.

  • INTERNET_FLAG_DONT_CACHE Speichern Sie die Daten weder lokal noch in Gateways zwischen.

  • INTERNET_FLAG_SECURE Fordern Sie sichere Transaktionen auf dem Draht mit Secure Sockets Layer oder PCT an. Dieses Flag gilt nur für HTTP-Anforderungen.

  • INTERNET_FLAG_USE_EXISTING Verwenden Sie nach Möglichkeit die vorhandenen Verbindungen mit dem Server für neue FindFile Anforderungen, anstatt für jede Anforderung eine neue Sitzung zu erstellen.

Rückgabewert

Ungleich Null, wenn erfolgreich, andernfalls 0 (Null). Rufen Sie zum Abrufen erweiterter Fehlerinformationen die Win32-Funktion GetLastError auf.

Hinweise

FindFile Nachdem Sie das erste Gopher-Objekt abgerufen haben, können Sie FindNextFile aufrufen, um nachfolgende Gopher-Dateien abzurufen.

CGopherFileFind::FindNextFile

Rufen Sie diese Memberfunktion auf, um eine Dateisuche fortzusetzen, die mit einem Aufruf von CGopherFileFind::FindFile begonnen hat.

virtual BOOL FindNextFile();

Rückgabewert

Nonzero, wenn mehr Dateien vorhanden sind; null, wenn die gefundene Datei die letzte im Verzeichnis ist oder wenn ein Fehler aufgetreten ist. Rufen Sie zum Abrufen erweiterter Fehlerinformationen die Win32-Funktion GetLastError auf. Wenn es sich bei der gefundenen Datei um die letzte Datei im Verzeichnis handelt oder wenn keine übereinstimmenden Dateien gefunden werden, gibt die GetLastError Funktion ERROR_NO_MORE_FILES zurück.

CGopherFileFind::GetCreationTime

Ruft die Erstellungszeit für die aktuelle Datei ab.

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

Parameter

pTimeStamp
Ein Zeiger auf eine FILETIME-Struktur , die die Erstellungszeit der Datei enthält.

refTime
Ein Verweis auf ein CTime-Objekt .

Rückgabewert

Nonzero bei erfolgreicher Ausführung; 0, wenn dies nicht erfolgreich ist. GetCreationTime gibt 0 nur zurück, wenn FindNextFile nie für dieses CGopherFileFind Objekt aufgerufen wurde.

Hinweise

Sie müssen FindNextFile mindestens einmal aufrufen, bevor Sie aufrufenGetCreationTime.

Hinweis

Nicht alle Dateisysteme verwenden dieselbe Semantik, um den von dieser Funktion zurückgegebenen Zeitstempel zu implementieren. Diese Funktion gibt möglicherweise denselben Wert zurück, der von anderen Zeitstempelfunktionen zurückgegeben wird, wenn das zugrunde liegende Dateisystem oder server das Zeitattribute nicht unterstützt. Informationen zu Zeitformaten finden Sie in der WIN32_FIND_DATA Struktur. Bei einigen Betriebssystemen befindet sich die zurückgegebene Uhrzeit in der lokalen Zeitzone des Computers, wenn sich die Datei befindet. Weitere Informationen finden Sie in der Win32 FileTimeToLocalFileTime-API .

CGopherFileFind::GetLastAccessTime

Ruft die Zeit ab, zu der die angegebene Datei zuletzt zugegriffen wurde.

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

Parameter

refTime
Ein Verweis auf ein CTime-Objekt .

pTimeStamp
Ein Zeiger auf eine FILETIME-Struktur mit dem Zeitpunkt, zu dem die Datei zuletzt zugegriffen wurde.

Rückgabewert

Nonzero bei erfolgreicher Ausführung; 0, wenn dies nicht erfolgreich ist. GetLastAccessTime gibt 0 nur zurück, wenn FindNextFile nie für dieses CGopherFileFind Objekt aufgerufen wurde.

Hinweise

Sie müssen FindNextFile mindestens einmal aufrufen, bevor Sie aufrufenGetLastAccessTime.

Hinweis

Nicht alle Dateisysteme verwenden dieselbe Semantik, um den von dieser Funktion zurückgegebenen Zeitstempel zu implementieren. Diese Funktion gibt möglicherweise denselben Wert zurück, der von anderen Zeitstempelfunktionen zurückgegeben wird, wenn das zugrunde liegende Dateisystem oder server das Zeitattribute nicht unterstützt. Informationen zu Zeitformaten finden Sie in der WIN32_FIND_DATA Struktur. Bei einigen Betriebssystemen befindet sich die zurückgegebene Uhrzeit in der lokalen Zeitzone des Computers, wenn sich die Datei befindet. Weitere Informationen finden Sie in der Win32 FileTimeToLocalFileTime-API .

CGopherFileFind::GetLastWriteTime

Ruft den Zeitpunkt der letzten Änderung der Datei ab.

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

Parameter

pTimeStamp
Ein Zeiger auf eine FILETIME-Struktur , die die Uhrzeit enthält, in die die Datei zuletzt geschrieben wurde.

refTime
Ein Verweis auf ein CTime-Objekt .

Rückgabewert

Nonzero bei erfolgreicher Ausführung; 0, wenn dies nicht erfolgreich ist. GetLastWriteTime gibt 0 nur zurück, wenn FindNextFile nie für dieses CGopherFileFind Objekt aufgerufen wurde.

Hinweise

Sie müssen FindNextFile mindestens einmal aufrufen, bevor Sie aufrufenGetLastWriteTime.

Hinweis

Nicht alle Dateisysteme verwenden dieselbe Semantik, um den von dieser Funktion zurückgegebenen Zeitstempel zu implementieren. Diese Funktion gibt möglicherweise denselben Wert zurück, der von anderen Zeitstempelfunktionen zurückgegeben wird, wenn das zugrunde liegende Dateisystem oder server das Zeitattribute nicht unterstützt. Informationen zu Zeitformaten finden Sie in der WIN32_FIND_DATA Struktur. Bei einigen Betriebssystemen befindet sich die zurückgegebene Uhrzeit in der lokalen Zeitzone des Computers, wenn sich die Datei befindet. Weitere Informationen finden Sie in der Win32 FileTimeToLocalFileTime-API .

CGopherFileFind::GetLength

Rufen Sie diese Memberfunktion auf, um die Länge der gefundenen Datei in Bytes abzurufen.

virtual ULONGLONG GetLength() const;

Rückgabewert

Die Länge der gefundenen Datei in Bytes.

Hinweise

GetLength verwendet die Win32-Struktur WIN32_FIND_DATA , um den Wert der Dateigröße in Byte abzurufen.

Hinweis

Ab MFC 7.0 GetLength unterstützt 64-Bit-Ganzzahltypen. Der zuvor vorhandene Code, der mit dieser neueren Version der Bibliothek erstellt wurde, kann zu Abkürzungswarnungen führen.

Beispiel

Sehen Sie sich das Beispiel für CFile::GetLength (die Basisklassenimplementierung) an.

CGopherFileFind::GetLocator

Rufen Sie diese Memberfunktion auf, um das CGopherLocator-Objekt abzurufen, das FindFile zum Suchen der Gopher-Datei verwendet.

CGopherLocator GetLocator() const;

Rückgabewert

Ein CGopherLocator-Objekt.

CGopherFileFind::GetScreenName

Rufen Sie diese Memberfunktion auf, um den Namen des Gopher-Bildschirms abzurufen.

CString GetScreenName() const;

Rückgabewert

Der Name des Gopher-Bildschirms.

CGopherFileFind::IsDots

Testet beim Durchlaufen von Dateien auf die aktuellen Verzeichnis- und übergeordneten Verzeichnismarkierungen.

virtual BOOL IsDots() const;

Rückgabewert

Nonzero, wenn die gefundene Datei den Namen "." oder ".." hat, was angibt, dass die gefundene Datei tatsächlich ein Verzeichnis ist. andernfalls 0.

Hinweise

Sie müssen FindNextFile mindestens einmal aufrufen, bevor Sie aufrufenIsDots.

Siehe auch

CFileFind-Klasse
Hierarchiediagramm
CFtpFileFind-Klasse
CFileFind-Klasse
CInternetFile-Klasse
CGopherFile-Klasse
CHttpFile-Klasse