Sdílet prostřednictvím

CGopherFileFind – třída

  • Článek

Pomůcky při vyhledávání internetových souborů serverů gopher.

Poznámka:

Třídy CGopherConnection, CGopherFilea CGopherFileFindCGopherLocator jejich členové jsou zastaralé, protože nefungují na platformě Windows XP, ale budou nadále pracovat na dřívějších platformách.

Syntaxe

class CGopherFileFind : public CFileFind

Členové

Veřejné konstruktory

Název Popis
CGopherFileFind::CGopherFileFind CGopherFileFind Vytvoří objekt.

Veřejné metody

Název Popis
CGopherFileFind::FindFile Najde soubor na serveru gopher.
CGopherFileFind::FindNextFile Pokračuje ve vyhledávání souborů z předchozího volání funkce FindFile.
CGopherFileFind::GetCreationTime Získá čas vytvoření zadaného souboru.
CGopherFileFind::GetLastAccessTime Získá čas posledního přístupu zadaného souboru.
CGopherFileFind::GetLastWriteTime Získá čas posledního zápisu zadaného souboru.
CGopherFileFind::GetLength Získá délku nalezeného souboru v bajtech.
CGopherFileFind::GetLocator Získání objektu CGopherLocator
CGopherFileFind::GetScreenName Získá název obrazovky gopheru.
CGopherFileFind::IsDots Testuje aktuální adresář a nadřazené značky adresáře při iterování prostřednictvím souborů.

Poznámky

CGopherFileFind obsahuje členské funkce, které začínají hledáním, vyhledávají soubor a vrací adresu URL souboru.

Mezi další třídy MFC určené pro vyhledávání v internetu a místních souborech patří CFtpFileFind a CFileFind. Společně s těmito třídami CGopherFileFindposkytují uživatelům bezproblémový mechanismus pro vyhledání konkrétních souborů bez ohledu na protokol serveru, typ souboru nebo umístění (buď místní počítač, nebo vzdálený server.) Všimněte si, že neexistuje žádná třída MFC pro vyhledávání na serverech HTTP, protože HTTP nepodporuje přímou manipulaci se soubory vyžadované vyhledáváním.

Poznámka:

CGopherFileFind nepodporuje následující členské funkce základní třídy CFileFind:

Kromě toho při použití CGopherFileFinds , CFileFind členské funkce IsDots je vždy FALSE.

Další informace o tom, jak používat CGopherFileFind a další třídy WinInet, naleznete v článku Internetové programování s WinInet.

Hierarchie dědičnosti

Objekt CObject

CFileFind

CGopherFileFind

Požadavky

Hlavička: afxinet.h

CGopherFileFind::CGopherFileFind

Tato členová funkce je volána k vytvoření objektu CGopherFileFind .

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

Parametry

pConnection
Ukazatel na objekt CGopherConnection .

dwContext
Identifikátor kontextu operace. Další informace o dwContext naleznete v části Poznámky.

Poznámky

Výchozí hodnota dwContext je odeslána mfc CGopherFileFind objektu z CInternetSession objektu, který vytvořil CGopherFileFind objekt. Při vytváření objektu CGopherFileFind můžete přepsat výchozí nastavení pro nastavení identifikátoru kontextu na hodnotu, kterou zvolíte. Identifikátor kontextu je vrácen do CInternetSession::OnStatusCallback poskytnout stav objektu, se kterým je identifikován. Další informace o identifikátoru kontextu najdete v článku Internet First Steps: WinInet .

CGopherFileFind::FindFile

Voláním této členské funkce vyhledejte soubor gopher.

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

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

Parametry

refLocator
Odkaz na objekt CGopherLocator .

pstrString
Ukazatel na řetězec obsahující název souboru.

dwFlags
Příznaky popisující, jak tuto relaci zpracovat. Platné příznaky jsou:

  • INTERNET_FLAG_RELOAD získat data ze vzdáleného serveru, i když jsou místně uložená v mezipaměti.

  • INTERNET_FLAG_DONT_CACHE Data neupamějte místně ani v žádné bráně.

  • INTERNET_FLAG_SECURE Vyžádání zabezpečených transakcí na drátu pomocí protokolu SECURE Sockets Layer nebo PCT. Tento příznak se vztahuje pouze na požadavky HTTP.

  • INTERNET_FLAG_USE_EXISTING Pokud je to možné, znovu použijte stávající připojení k serveru pro nové FindFile požadavky místo vytvoření nové relace pro každou žádost.

Návratová hodnota

Nenulové, pokud je úspěšné; jinak 0. Pokud chcete získat rozšířené informace o chybě, zavolejte funkci Win32 GetLastError.

Poznámky

Po volání FindFile načíst první gopher objekt, můžete volat FindNextFile načíst další gopher soubory.

CGopherFileFind::FindNextFile

Voláním této členské funkce pokračujte v hledání souborů zahájeným voláním CGopherFileFind::FindFile.

virtual BOOL FindNextFile();

Návratová hodnota

Nenulové, pokud jsou k dispozici více souborů; Nula, pokud nalezený soubor je poslední v adresáři nebo pokud došlo k chybě. Pokud chcete získat rozšířené informace o chybě, zavolejte funkci Win32 GetLastError. Pokud nalezený soubor je posledním souborem v adresáři nebo pokud se nedají najít žádné odpovídající soubory, GetLastError vrátí funkce ERROR_NO_MORE_FILES.

CGopherFileFind::GetCreationTime

Získá čas vytvoření aktuálního souboru.

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

Parametry

pTimeStamp
Ukazatel na strukturu FILETIME obsahující čas vytvoření souboru.

refTime
Odkaz na objekt CTime .

Návratová hodnota

Nenulové, pokud je úspěšné; 0 v případě neúspěchu. GetCreationTime vrátí hodnotu 0 pouze v případě, že Funkce FindNextFile nebyla nikdy volána pro tento CGopherFileFind objekt.

Poznámky

Před voláním je nutné volat GetCreationTimeFindNextFile alespoň jednou .

Poznámka:

Ne všechny systémy souborů používají stejnou sémantiku k implementaci časového razítka vráceného touto funkcí. Tato funkce může vrátit stejnou hodnotu vrácenou jinými funkcemi časového razítka, pokud základní systém souborů nebo server nepodporuje zachování atributu času. Informace o formátech času najdete ve struktuře WIN32_FIND_DATA. V některých operačních systémech se vrácený čas nachází v místním časovém pásmu počítače. Další informace najdete v rozhraní API Win32 FileTimeToLocalFileTime .

CGopherFileFind::GetLastAccessTime

Získá čas posledního přístupu zadaného souboru.

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

Parametry

refTime
Odkaz na objekt CTime .

pTimeStamp
Ukazatel na strukturu FILETIME obsahující čas posledního přístupu k souboru.

Návratová hodnota

Nenulové, pokud je úspěšné; 0 v případě neúspěchu. GetLastAccessTime vrátí hodnotu 0 pouze v případě, že Funkce FindNextFile nebyla nikdy volána pro tento CGopherFileFind objekt.

Poznámky

Před voláním je nutné volat GetLastAccessTimeFindNextFile alespoň jednou .

Poznámka:

Ne všechny systémy souborů používají stejnou sémantiku k implementaci časového razítka vráceného touto funkcí. Tato funkce může vrátit stejnou hodnotu vrácenou jinými funkcemi časového razítka, pokud základní systém souborů nebo server nepodporuje zachování atributu času. Informace o formátech času najdete ve struktuře WIN32_FIND_DATA. V některých operačních systémech se vrácený čas nachází v místním časovém pásmu počítače. Další informace najdete v rozhraní API Win32 FileTimeToLocalFileTime .

CGopherFileFind::GetLastWriteTime

Získá čas poslední změny souboru.

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

Parametry

pTimeStamp
Ukazatel na strukturu FILETIME obsahující čas posledního zápisu souboru.

refTime
Odkaz na objekt CTime .

Návratová hodnota

Nenulové, pokud je úspěšné; 0 v případě neúspěchu. GetLastWriteTime vrátí hodnotu 0 pouze v případě, že Funkce FindNextFile nebyla nikdy volána pro tento CGopherFileFind objekt.

Poznámky

Před voláním je nutné volat GetLastWriteTimeFindNextFile alespoň jednou .

Poznámka:

Ne všechny systémy souborů používají stejnou sémantiku k implementaci časového razítka vráceného touto funkcí. Tato funkce může vrátit stejnou hodnotu vrácenou jinými funkcemi časového razítka, pokud základní systém souborů nebo server nepodporuje zachování atributu času. Informace o formátech času najdete ve struktuře WIN32_FIND_DATA. V některých operačních systémech se vrácený čas nachází v místním časovém pásmu počítače. Další informace najdete v rozhraní API Win32 FileTimeToLocalFileTime .

CGopherFileFind::GetLength

Voláním této členské funkce získáte délku nalezeného souboru v bajtech.

virtual ULONGLONG GetLength() const;

Návratová hodnota

Délka nalezeného souboru v bajtech.

Poznámky

GetLength používá strukturu Win32 WIN32_FIND_DATA získat hodnotu velikosti souboru v bajtech.

Poznámka:

Od mfc 7.0 GetLength podporuje 64bitové celočíselné typy. Dříve existující kód vytvořený s touto novější verzí knihovny může vést k zkrácení upozornění.

Příklad

Podívejte se na příklad pro CFile::GetLength (implementace základní třídy).

CGopherFileFind::GetLocator

Voláním této členské funkce získáte CGopherLocator objekt, který FindFile používá k vyhledání souboru gopher.

CGopherLocator GetLocator() const;

Návratová hodnota

Objekt CGopherLocator .

CGopherFileFind::GetScreenName

Voláním této členské funkce získáte název obrazovky gopher.

CString GetScreenName() const;

Návratová hodnota

Název obrazovky gopher.

CGopherFileFind::IsDots

Testuje aktuální adresář a nadřazené značky adresáře při iterování prostřednictvím souborů.

virtual BOOL IsDots() const;

Návratová hodnota

Nenulové, pokud nalezený soubor obsahuje název "." nebo ".", což znamená, že nalezený soubor je ve skutečnosti adresář. Jinak 0.

Poznámky

Před voláním je nutné volat IsDotsFindNextFile alespoň jednou .

Viz také

CFileFind – třída
Graf hierarchie
CFtpFileFind – třída
CFileFind – třída
CInternetFile – třída
CGopherFile – třída
CHttpFile – třída