CGopherFileFind – třída
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
| Jméno | popis |
|---|---|
| CGopherFileFind::CGopherFileFind | CGopherFileFind Vytvoří objekt. |
Veřejné metody
| Jméno | 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
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
p Připojení ion
Ukazatel na objekt CGopher Připojení ion.
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é
FindFilepožadavky místo vytvoření nové relace pro každou žádost.
Vrácená 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();
Vrácená 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 .
Vrácená 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.
Vrácená 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 .
Vrácená 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;
Vrácená 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;
Vrácená hodnota
Objekt CGopherLocator .
CGopherFileFind::GetScreenName
Voláním této členské funkce získáte název obrazovky gopher.
CString GetScreenName() const;
Vrácená 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;
Vrácená 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
Váš názor
Připravujeme: V průběhu roku 2024 budeme postupně vyřazovat problémy z GitHub coby mechanismus zpětné vazby pro obsah a nahrazovat ho novým systémem zpětné vazby. Další informace naleznete v tématu: https://aka.ms/ContentUserFeedback.
Odeslat a zobrazit názory pro