CFtpConnection::GetFile
Volání funkce tohoto člena načíst soubor ze serveru FTP a uložit v místním počítači.
BOOL GetFile(
LPCTSTR pstrRemoteFile,
LPCTSTR pstrLocalFile,
BOOL bFailIfExists = TRUE,
DWORD dwAttributes = FILE_ATTRIBUTE_NORMAL,
DWORD dwFlags = FTP_TRANSFER_TYPE_BINARY,
DWORD_PTR dwContext = 1
);
Parametry
pstrRemoteFile
Ukazatel zakončený řetězec obsahující název souboru načtení ze serveru FTP.pstrLocalFile
Ukazatel na řetězec zakončený obsahující název souboru, který chcete vytvořit v místním systému.bFailIfExists
Označuje, zda název souboru může použít již existující soubor.Pokud název místního souboru již existuje a je tento parametr TRUE, GetFile se nezdaří.Jinak GetFile vymaže stávající kopie souboru.dwAttributes
Označuje atributy souboru.To může být libovolná kombinace následujících příznaků FILE_ATTRIBUTE_ *.FILE_ATTRIBUTE_ARCHIVE soubor je soubor archivu.Aplikace používají tento atribut k označení souborů pro zálohu nebo odstranění.
FILE_ATTRIBUTE_COMPRESSED soubor nebo adresář je komprimován.Soubor komprese znamená komprimované všechna data v souboru.Komprese adresáře, je výchozí pro nově vytvořené soubory a podadresáře.
FILE_ATTRIBUTE_DIRECTORY soubor je adresář.
FILE_ATTRIBUTE_NORMAL soubor nemá žádné atributy nastavit.Tento atribut je platný pouze v případě, že je použit samostatně.Přepsat všechny ostatní atributy souboru FILE_ATTRIBUTE_NORMAL:
FILE_ATTRIBUTE_HIDDEN soubor je skrytý.Nejsou součástí běžných výpis.
FILE_ATTRIBUTE_READONLY soubor je jen pro čtení.Aplikace mohou číst soubor, ale nelze do ní zapisovat nebo jej odstraňte.
FILE_ATTRIBUTE_SYSTEM je součástí souboru nebo je používán výhradně operačního systému.
FILE_ATTRIBUTE_TEMPORARY soubor je používán pro dočasné úložiště.Aplikace by do souboru zapisovat pouze, pokud je to nezbytně nutné.Většinu dat souboru zůstane v paměti bez právě vyprázdněna média, protože soubor bude brzy odstranit.
dwFlags
Určuje podmínky, za kterých dojde k převodu.Tento parametr může být dwFlags hodnoty popsané v FtpGetFile v .dwContext
Identifikátor kontext pro načtení souboru.Viz poznámky Další informace o dwContext .
Vrácená hodnota
Nenulová hodnota, pokud je úspěšná. jinak 0.Pokud selže volání funkce Win32 GetLastError může být volána zjistit příčinu chyby.
Poznámky
GetFileje vysoké úrovni rutina, která zpracovává všechny nároky spojené s čtení souboru ze serveru FTP a jejich uložením místně.Použijte aplikace, pouze načíst data soubor nebo Zavřít kontrolu nad přenos souborů, které vyžadují OpenFile a CInternetFile::Read místo.
Pokud dwFlags FILE_TRANSFER_TYPE_ASCII, překlad souboru dat je také převádí řízení a formátování znaků na ekvivalenty systému Windows.Výchozí přenos je binární režim, kde stažení souboru ve stejném formátu jako je uložen na serveru.
I pstrRemoteFile a pstrLocalFile může být buď částečně kvalifikovaných názvů souborů v aktuálním adresáři nebo úplný.Zpětné lomítko (\) nebo lomítko (/) lze jako oddělovač buď název adresáře.GetFilePřeloží název oddělovače adresáře na odpovídající znaky před jejich použitím.
Přepsat dwContext výchozí nastavení na hodnotu zadávají identifikátor kontextu.Kontext identifikátoru je přidružen k této konkrétní provoz CFtpConnection objekt vytvořený jeho CInternetSession objektu.Je vrácena hodnota CInternetSession::OnStatusCallback zadat stav na operace, které je určen.Naleznete v článku první kroky Internet: WinInet Další informace o identifikátoru kontextu.
Požadavky
Záhlaví: afxinet.h