CGopherFileFind osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Segédeszközök a gopher-kiszolgálók internetes fájlkeresésében.

Megjegyzés:

Az osztályok CGopherConnectionCGopherFileCGopherFileFindCGopherLocator és tagjaik elavultak, mert nem működnek a Windows XP platformon, de továbbra is a korábbi platformokon fognak működni.

Szemantika

class CGopherFileFind : public CFileFind

Tagok

Nyilvános konstruktorok

Név	Description
CGopherFileFind::CGopherFileFind	Egy CGopherFileFind objektumot hoz létre.

Nyilvános metódusok

Név	Description
CGopherFileFind::FindFile	Megkeres egy fájlt egy gopher-kiszolgálón.
CGopherFileFind::FindNextFile	Folytatja a fájlkeresést a FindFile korábbi hívásából.
CGopherFileFind::GetCreationTime	Lekéri a megadott fájl létrehozásának idejét.
CGopherFileFind::GetLastAccessTime	Lekéri a megadott fájl utolsó elérésének időpontját.
CGopherFileFind::GetLastWriteTime	Lekéri a megadott fájl utolsó írási idejét.
CGopherFileFind::GetLength	Bájtban lekéri a talált fájl hosszát.
CGopherFileFind::GetLocator	Objektum lekérése CGopherLocator .
CGopherFileFind::GetScreenName	Lekéri a gopher képernyő nevét.
CGopherFileFind::IsDots	Az aktuális könyvtár és a szülőkönyvtár jelölőinek tesztelése a fájlokon keresztüli iterálás során.

Megjegyzések

CGopherFileFind olyan tagfüggvényeket tartalmaz, amelyek keresést indítanak, megkeresnek egy fájlt, és visszaadják a fájl URL-címét.

Az internethez és a helyi fájlkereséshez tervezett egyéb MFC-osztályok közé tartozik a CFtpFileFind és a CFileFind. Ezekkel az osztályokkal CGopherFileFindegyütt zökkenőmentes mechanizmust biztosítanak a felhasználó számára adott fájlok megkereséséhez, függetlenül a kiszolgálóprotokolltól, a fájltípustól vagy a helytől (helyi géptől vagy távoli kiszolgálótól). Vegye figyelembe, hogy a HTTP-kiszolgálókon való kereséshez nincs MFC-osztály, mert a HTTP nem támogatja a keresésekhez szükséges közvetlen fájlkezelést.

Megjegyzés:

CGopherFileFind nem támogatja a CFileFind alaposztály következő tagfüggvényeit:

• GetRoot

• GetFileName

• GetFilePath

• GetFileTitle

• GetFileURL

Emellett az CGopherFileFindCFileFindIsDots tagfüggvény mindig HAMIS.

A használat CGopherFileFind módjáról és a WinInet többi osztályáról a WinInettel való internetes programozás című cikkben talál további információt.

Öröklési hierarchia

CObject

CFileFind

CGopherFileFind

Requirements

Fejléc: afxinet.h

CGopherFileFind::CGopherFileFind

Ez a tagfüggvény egy CGopherFileFind objektum létrehozásához van meghívva.

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

Paraméterek

pConnection
Egy CGopherConnection objektumra mutató mutató.

dwContext
A művelet környezeti azonosítója. A dwContextről további információt a Megjegyzések című témakörben talál.

Megjegyzések

A dwContext alapértelmezett értékét az MFC küldi el az CGopherFileFind objektumnak az objektumot létrehozó CGopherFileFindCInternetSession objektumból. Objektum létrehozásakor CGopherFileFind felülbírálhatja az alapértelmezett értéket, hogy a környezetazonosítót egy ön által választott értékre állítsa. A rendszer visszaadja a környezetazonosítót a CInternetSession::OnStatusCallback fájlnak, hogy állapotot adjon meg azon az objektumon, amellyel azonosítva van. A környezetazonosítóval kapcsolatos további információkért tekintse meg az internet első lépései: WinInet című cikket.

CGopherFileFind::FindFile

Hívja meg ezt a tagfüggvényt egy gopher-fájl megkereséséhez.

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

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

Paraméterek

refLocator
Hivatkozás egy CGopherLocator-objektumra .

pstrString
A fájlnevet tartalmazó sztringre mutató mutató.

dwFlags
A munkamenet kezelését leíró jelzők. Az érvényes jelzők a következők:

• INTERNET_FLAG_RELOAD Lekérheti az adatokat a távoli kiszolgálóról, még akkor is, ha azokat helyileg gyorsítótárazza.

• INTERNET_FLAG_DONT_CACHE Ne gyorsítótárazza az adatokat helyileg vagy átjárókban.

• INTERNET_FLAG_SECURE Biztonságos tranzakciók kérése a vezetéken Secure Sockets Layer vagy PCT használatával. Ez a jelző csak HTTP-kérelmekre vonatkozik.

• INTERNET_FLAG_USE_EXISTING Ha lehetséges, használja újra a kiszolgáló meglévő kapcsolatait új FindFile kérésekhez, és ne hozzon létre új munkamenetet az egyes kérésekhez.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0. A kiterjesztett hibainformációk lekéréséhez hívja meg a GetLastError Win32 függvényt.

Megjegyzések

Miután meghívta FindFile az első gopher objektumot, meghívhatja a FindNextFile-t a további gopher-fájlok lekéréséhez.

CGopherFileFind::FindNextFile

Hívja meg ezt a tagfüggvényt a CGopherFileFind::FindFile hívásával megkezdett fájlkeresés folytatásához.

virtual BOOL FindNextFile();

Visszaadott érték

Nonzero, ha több fájl van; nulla, ha a talált fájl az utolsó a könyvtárban, vagy ha hiba történt. A kiterjesztett hibainformációk lekéréséhez hívja meg a GetLastError Win32 függvényt. Ha a talált fájl az utolsó fájl a könyvtárban, vagy ha nem található egyező fájl, a GetLastError függvény ERROR_NO_MORE_FILES ad vissza.

CGopherFileFind::GetCreationTime

Lekéri az aktuális fájl létrehozási idejét.

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

Paraméterek

pTimeStamp
A fájl létrehozásának időpontját tartalmazó FILETIME-struktúra mutatója.

refTime
Hivatkozás egy CTime-objektumra .

Visszaadott érték

Nonzero, ha sikeres; 0, ha sikertelen. GetCreationTime csak akkor ad vissza 0 értéket, ha a FindNextFile soha nem lett meghívva ezen CGopherFileFind az objektumon.

Megjegyzések

Hívás előtt legalább egyszer meg kell hívnia a FindNextFile fájlt GetCreationTime.

Megjegyzés:

Nem minden fájlrendszer használja ugyanazt a szemantikát a függvény által visszaadott időbélyeg implementálásához. Ez a függvény visszaadhatja ugyanazt az értéket, amelyet más időbélyegfüggvények visszaadnak, ha az alapul szolgáló fájlrendszer vagy kiszolgáló nem támogatja az időattribútum megtartását. Az időformátumokról az WIN32_FIND_DATA szerkezetében olvashat. Egyes operációs rendszereken a visszaadott idő a gép helyi időzónájában található, ha a fájl található. További információért tekintse meg a Win32 FileTimeToLocalFileTime API-t.

CGopherFileFind::GetLastAccessTime

Lekéri a megadott fájl utolsó elérésének időpontját.

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

Paraméterek

refTime
Hivatkozás egy CTime-objektumra .

pTimeStamp
Mutató egy FILETIME-struktúrára , amely tartalmazza a fájl utolsó elérésének időpontját.

Visszaadott érték

Nonzero, ha sikeres; 0, ha sikertelen. GetLastAccessTime csak akkor ad vissza 0 értéket, ha a FindNextFile soha nem lett meghívva ezen CGopherFileFind az objektumon.

Megjegyzések

Hívás előtt legalább egyszer meg kell hívnia a FindNextFile fájlt GetLastAccessTime.

Megjegyzés:

Nem minden fájlrendszer használja ugyanazt a szemantikát a függvény által visszaadott időbélyeg implementálásához. Ez a függvény visszaadhatja ugyanazt az értéket, amelyet más időbélyegfüggvények visszaadnak, ha az alapul szolgáló fájlrendszer vagy kiszolgáló nem támogatja az időattribútum megtartását. Az időformátumokról az WIN32_FIND_DATA szerkezetében olvashat. Egyes operációs rendszereken a visszaadott idő a gép helyi időzónájában található, ha a fájl található. További információért tekintse meg a Win32 FileTimeToLocalFileTime API-t.

CGopherFileFind::GetLastWriteTime

A fájl legutóbbi módosításának időpontja.

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

Paraméterek

pTimeStamp
Mutató egy FILETIME-struktúrára , amely tartalmazza a fájl utolsó írási idejét.

refTime
Hivatkozás egy CTime-objektumra .

Visszaadott érték

Nonzero, ha sikeres; 0, ha sikertelen. GetLastWriteTime csak akkor ad vissza 0 értéket, ha a FindNextFile soha nem lett meghívva ezen CGopherFileFind az objektumon.

Megjegyzések

Hívás előtt legalább egyszer meg kell hívnia a FindNextFile fájlt GetLastWriteTime.

Megjegyzés:

Nem minden fájlrendszer használja ugyanazt a szemantikát a függvény által visszaadott időbélyeg implementálásához. Ez a függvény visszaadhatja ugyanazt az értéket, amelyet más időbélyegfüggvények visszaadnak, ha az alapul szolgáló fájlrendszer vagy kiszolgáló nem támogatja az időattribútum megtartását. Az időformátumokról az WIN32_FIND_DATA szerkezetében olvashat. Egyes operációs rendszereken a visszaadott idő a gép helyi időzónájában található, ha a fájl található. További információért tekintse meg a Win32 FileTimeToLocalFileTime API-t.

CGopherFileFind::GetLength

Hívja meg ezt a tagfüggvényt a talált fájl hosszának bájtban való lekéréséhez.

virtual ULONGLONG GetLength() const;

Visszaadott érték

A talált fájl hossza bájtban.

Megjegyzések

GetLength A Win32-struktúra WIN32_FIND_DATA használatával lekéri a fájlméret bájtban megadott értékét.

Megjegyzés:

Az MFC 7.0-s GetLength verziójában a 64 bites egész számtípusok támogatottak. A kódtár újabb verziójával létrehozott, korábban már meglévő kód csonkítási figyelmeztetéseket eredményezhet.

Example

Lásd a CFile::GetLength (az alaposztály implementációja) példáját.

CGopherFileFind::GetLocator

Hívja meg ezt a tagfüggvényt, hogy lekérje a FindFile által a gopher fájl megkereséséhez használt CGopherLocator objektumot.

CGopherLocator GetLocator() const;

Visszaadott érték

Egy CGopherLocator objektum.

CGopherFileFind::GetScreenName

Hívja meg ezt a tagfüggvényt a gopher képernyő nevének lekéréséhez.

CString GetScreenName() const;

Visszaadott érték

A gopher képernyő neve.

CGopherFileFind::IsDots

Az aktuális könyvtár és a szülőkönyvtár jelölőinek tesztelése a fájlokon keresztüli iterálás során.

virtual BOOL IsDots() const;

Visszaadott érték

Nonzero, ha a talált fájl neve "." vagy "..", ami azt jelzi, hogy a talált fájl valójában egy könyvtár. Egyéb esetben 0.

Megjegyzések

Hívás előtt legalább egyszer meg kell hívnia a FindNextFile fájlt IsDots.

Lásd még

CFileFind osztály
hierarchiadiagram
CFtpFileFind osztály
CFileFind osztály
CInternetFile osztály
CGopherFile osztály
CHttpFile osztály