Share via

CGopherFileFind-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Hulpmiddelen voor zoekopdrachten in internetbestanden van gopher-servers.

Opmerking

De klassenCGopherConnection, CGopherFileen CGopherFileFindCGopherLocator hun leden zijn afgeschaft omdat ze niet werken op het Windows XP-platform, maar ze blijven werken op eerdere platforms.

Syntaxis

class CGopherFileFind : public CFileFind

Leden

Openbare constructors

Naam Description
CGopherFileFind::CGopherFileFind Maakt een CGopherFileFind object.

Openbare methoden

Naam Description
CGopherFileFind::FindFile Hiermee vindt u een bestand op een gopher-server.
CGopherFileFind::FindNextFile Hiermee gaat u door met het zoeken van bestanden vanuit een eerdere aanroep naar FindFile.
CGopherFileFind::GetCreationTime Hiermee wordt de tijd opgehaald waarop het opgegeven bestand is gemaakt.
CGopherFileFind::GetLastAccessTime Hiermee wordt de tijd opgehaald waarop het opgegeven bestand voor het laatst is geopend.
CGopherFileFind::GetLastWriteTime Hiermee wordt de tijd opgehaald waarop het opgegeven bestand voor het laatst is geschreven.
CGopherFileFind::GetLength Hiermee wordt de lengte van het gevonden bestand, in bytes, opgeslagen.
CGopherFileFind::GetLocator CGopherLocator Een object ophalen.
CGopherFileFind::GetScreenName Hiermee haalt u de naam van een gopher-scherm op.
CGopherFileFind::IsDots Test de huidige map- en bovenliggende mapmarkeringen tijdens het doorlopen van bestanden.

Opmerkingen

CGopherFileFind bevat lidfuncties die een zoekopdracht starten, een bestand zoeken en de URL van een bestand retourneren.

Andere MFC-klassen die zijn ontworpen voor internet en lokaal bestand dat wordt doorzocht, zijn CFtpFileFind en CFileFind. Samen met CGopherFileFinddeze klassen biedt deze klassen een naadloos mechanisme voor de gebruiker om specifieke bestanden te vinden, ongeacht het serverprotocol, bestandstype of locatie (een lokale computer of een externe server.) Houd er rekening mee dat er geen MFC-klasse is voor zoeken op HTTP-servers, omdat HTTP geen ondersteuning biedt voor de directe bestandsbewerking die is vereist voor zoekopdrachten.

Opmerking

CGopherFileFind biedt geen ondersteuning voor de volgende lidfuncties van de basisklasse CFileFind:

Bovendien is de CFileFind lidfunctie IsDots altijd ONWAAR wanneer deze wordt gebruiktCGopherFileFind.

Zie het artikel Internetprogrammering met WinInet voor meer informatie over het gebruik CGopherFileFind en de andere WinInet-klassen.

Overnamehiërarchie

CObject

CFileFind

CGopherFileFind

Requirements

Koptekst: afxinet.h

CGopherFileFind::CGopherFileFind

Deze lidfunctie wordt aangeroepen om een CGopherFileFind object te maken.

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

Parameterwaarden

pConnection
Een aanwijzer naar een CGopherConnection-object .

dwContext
De context-id voor de bewerking. Zie Opmerkingen voor meer informatie over dwContext.

Opmerkingen

De standaardwaarde voor dwContext wordt door MFC verzonden naar het CGopherFileFind object van het CInternetSession-object dat het CGopherFileFind object heeft gemaakt. Wanneer u een CGopherFileFind object maakt, kunt u de standaardinstelling overschrijven om de context-id in te stellen op een waarde van uw keuze. De context-id wordt geretourneerd naar CInternetSession::OnStatusCallback om de status op te geven van het object waarmee het wordt geïdentificeerd. Zie het artikel Internet First Steps: WinInet voor meer informatie over de context-id.

CGopherFileFind::FindFile

Roep deze lidfunctie aan om een gopher-bestand te zoeken.

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

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

Parameterwaarden

refLocator
Een verwijzing naar een CGopherLocator-object .

pstrString
Een aanwijzer naar een tekenreeks met de bestandsnaam.

dwFlags
De vlaggen die beschrijven hoe deze sessie moet worden verwerkt. De geldige vlaggen zijn:

  • INTERNET_FLAG_RELOAD De gegevens van de externe server ophalen, zelfs als deze lokaal in de cache zijn opgeslagen.

  • INTERNET_FLAG_DONT_CACHE De gegevens niet opslaan in de cache, lokaal of in gateways.

  • INTERNET_FLAG_SECURE veilige transacties op de kabel aanvragen met Secure Sockets Layer of PCT. Deze vlag is alleen van toepassing op HTTP-aanvragen.

  • INTERNET_FLAG_USE_EXISTING Gebruik indien mogelijk de bestaande verbindingen met de server opnieuw voor nieuwe FindFile aanvragen in plaats van een nieuwe sessie voor elke aanvraag te maken.

Retourwaarde

Niet-nul indien geslaagd; anders 0. Als u uitgebreide foutinformatie wilt ophalen, roept u de Win32-functie GetLastError aan.

Opmerkingen

Nadat u hebt aangeroepen FindFile om het eerste gopher-object op te halen, kunt u FindNextFile aanroepen om volgende gopher-bestanden op te halen.

CGopherFileFind::FindNextFile

Roep deze lidfunctie aan om door te gaan met een bestandszoekopdracht die is gestart met een aanroep naar CGopherFileFind::FindFile.

virtual BOOL FindNextFile();

Retourwaarde

Niet-nul als er meer bestanden zijn; nul als het gevonden bestand de laatste in de map is of als er een fout is opgetreden. Als u uitgebreide foutinformatie wilt ophalen, roept u de Win32-functie GetLastError aan. Als het gevonden bestand het laatste bestand in de map is of als er geen overeenkomende bestanden kunnen worden gevonden, retourneert de GetLastError functie ERROR_NO_MORE_FILES.

CGopherFileFind::GetCreationTime

Hiermee haalt u de aanmaaktijd voor het huidige bestand op.

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

Parameterwaarden

pTimeStamp
Een aanwijzer naar een FILETIME-structuur die de tijd bevat waarop het bestand is gemaakt.

refTime
Een verwijzing naar een CTime-object .

Retourwaarde

Niet-nul indien geslaagd; 0 indien mislukt. GetCreationTime retourneert alleen 0 als FindNextFile nog nooit op dit CGopherFileFind object is aangeroepen.

Opmerkingen

U moet FindNextFile minstens één keer aanroepen voordat u aanroept GetCreationTime.

Opmerking

Niet alle bestandssystemen gebruiken dezelfde semantiek om het tijdstempel te implementeren dat door deze functie wordt geretourneerd. Deze functie kan dezelfde waarde retourneren die door andere tijdstempelfuncties wordt geretourneerd als het onderliggende bestandssysteem of de onderliggende server het tijdkenmerk niet ondersteunt. Zie de WIN32_FIND_DATA structuur voor informatie over tijdnotaties. Op sommige besturingssystemen bevindt de geretourneerde tijd zich in de tijdzone lokaal op de computer, waar het bestand zich bevindt. Zie de Win32 FileTimeToLocalFileTime-API voor meer informatie.

CGopherFileFind::GetLastAccessTime

Hiermee wordt de tijd opgehaald waarop het opgegeven bestand voor het laatst is geopend.

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

Parameterwaarden

refTime
Een verwijzing naar een CTime-object .

pTimeStamp
Een aanwijzer naar een FILETIME-structuur die de tijd bevat waarop het bestand voor het laatst is geopend.

Retourwaarde

Niet-nul indien geslaagd; 0 indien mislukt. GetLastAccessTime retourneert alleen 0 als FindNextFile nog nooit op dit CGopherFileFind object is aangeroepen.

Opmerkingen

U moet FindNextFile minstens één keer aanroepen voordat u aanroept GetLastAccessTime.

Opmerking

Niet alle bestandssystemen gebruiken dezelfde semantiek om het tijdstempel te implementeren dat door deze functie wordt geretourneerd. Deze functie kan dezelfde waarde retourneren die door andere tijdstempelfuncties wordt geretourneerd als het onderliggende bestandssysteem of de onderliggende server het tijdkenmerk niet ondersteunt. Zie de WIN32_FIND_DATA structuur voor informatie over tijdnotaties. Op sommige besturingssystemen bevindt de geretourneerde tijd zich in de tijdzone lokaal op de computer, waar het bestand zich bevindt. Zie de Win32 FileTimeToLocalFileTime-API voor meer informatie.

CGopherFileFind::GetLastWriteTime

Hiermee wordt de laatste keer dat het bestand is gewijzigd, opgehaald.

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

Parameterwaarden

pTimeStamp
Een aanwijzer naar een FILETIME-structuur met de tijd waarop het bestand voor het laatst is geschreven.

refTime
Een verwijzing naar een CTime-object .

Retourwaarde

Niet-nul indien geslaagd; 0 indien mislukt. GetLastWriteTime retourneert alleen 0 als FindNextFile nog nooit op dit CGopherFileFind object is aangeroepen.

Opmerkingen

U moet FindNextFile minstens één keer aanroepen voordat u aanroept GetLastWriteTime.

Opmerking

Niet alle bestandssystemen gebruiken dezelfde semantiek om het tijdstempel te implementeren dat door deze functie wordt geretourneerd. Deze functie kan dezelfde waarde retourneren die door andere tijdstempelfuncties wordt geretourneerd als het onderliggende bestandssysteem of de onderliggende server het tijdkenmerk niet ondersteunt. Zie de WIN32_FIND_DATA structuur voor informatie over tijdnotaties. Op sommige besturingssystemen bevindt de geretourneerde tijd zich in de tijdzone lokaal op de computer, waar het bestand zich bevindt. Zie de Win32 FileTimeToLocalFileTime-API voor meer informatie.

CGopherFileFind::GetLength

Roep deze lidfunctie aan om de lengte in bytes van het gevonden bestand op te halen.

virtual ULONGLONG GetLength() const;

Retourwaarde

De lengte, in bytes, van het gevonden bestand.

Opmerkingen

GetLength gebruikt de Win32-structuur WIN32_FIND_DATA om de waarde van de bestandsgrootte in bytes op te halen.

Opmerking

Vanaf MFC 7.0 ondersteunt GetLength 64-bits gehele getallentypen. Eerder bestaande code die is gebouwd met deze nieuwere versie van de bibliotheek, kan leiden tot afkappingswaarschuwingen.

Example

Zie het voorbeeld voor CFile::GetLength (de implementatie van de basisklasse).

CGopherFileFind::GetLocator

Roep deze lidfunctie aan om het CGopherLocator-object op te halen dat findFile gebruikt om het gopher-bestand te vinden.

CGopherLocator GetLocator() const;

Retourwaarde

Een CGopherLocator-object.

CGopherFileFind::GetScreenName

Roep deze lidfunctie aan om de naam van het gopher-scherm op te halen.

CString GetScreenName() const;

Retourwaarde

De naam van het gopher-scherm.

CGopherFileFind::IsDots

Test de huidige map- en bovenliggende mapmarkeringen tijdens het doorlopen van bestanden.

virtual BOOL IsDots() const;

Retourwaarde

Nonzero als het gevonden bestand de naam '.' of '.' heeft, wat aangeeft dat het gevonden bestand eigenlijk een map is. Anders 0.

Opmerkingen

U moet FindNextFile minstens één keer aanroepen voordat u aanroept IsDots.

Zie ook

CFileFind-klasse
Hiërarchiegrafiek
CFtpFileFind-klasse
CFileFind-klasse
CInternetFile-klasse
CGopherFile-klasse
CHttpFile-klasse

  • Last updated on