CFtpConnection::OpenFile
Volání funkce tohoto člena otevřete soubor umístěný na serveru FTP pro čtení či zápis.
CInternetFile* OpenFile(
LPCTSTR pstrFileName,
DWORD dwAccess = GENERIC_READ,
DWORD dwFlags = FTP_TRANSFER_TYPE_BINARY,
DWORD_PTR dwContext = 1
);
Parametry
pstrFileName
Ukazatel na řetězec obsahující název souboru, který chcete otevřít.dwAccess
Určuje, jak bude soubor přístupný.Může být všeobecné_čtení nebo všeobecné_zápis, ale ne obojí.dwFlags
Určuje podmínky, za kterých dojde k následné převody.To může být některý z následujících konstant FTP_TRANSFER_ *:FTP_TRANSFER_TYPE_ASCII soubor přenosy pomocí metody přenosu FTP ASCII (typ A).Ovládací prvek převádí a informace o formátování na místní ekvivalenty.
FTP_TRANSFER_TYPE_BINARY soubor přenáší data pomocí metody přenosu obrazu FTP's (typ I).Přenosy dat souboru přesně jako existuje bez úprav.Toto je výchozí metodu přenosu.
dwContext
Identifikátor kontext pro otevření souboru.Viz poznámky Další informace o dwContext .
Vrácená hodnota
Ukazatel CInternetFile objektu.
Poznámky
OpenFileby měl být používán následujících situacích:
Aplikace obsahuje data, která potřebuje odeslána a vytvořen jako soubor na serveru FTP, ale, že data nejsou v místním souboru.Jednou OpenFile otevře soubor aplikace používá CInternetFile::Write k odeslání souboru dat FTP serveru.
Aplikace musí načíst soubor ze serveru a umístěte jej do paměti řízené aplikací místo zápisu na disk.Aplikace používá CInternetFile::Read po použití OpenFile k otevření souboru.
Aplikace potřebuje jemné úroveň kontroly nad přenos souboru.Aplikace může například zobrazit ukazatel průběhu řízení určení průběhu stav přenosu souborů při stahování souboru.
Po volání OpenFile do volání CInternetConnection::Close, aplikace může volat pouze CInternetFile::Read, CInternetFile::Write, CInternetConnection::Close, nebo CFtpFileFind::FindFile.Volání jiných funkcí FTP pro stejnou relaci FTP se nezdaří a nastavte kód chyby FTP_ETRANSFER_IN_PROGRESS.
pstrFileName Parametr může být buď částečně kvalifikovaný název souboru relativní k aktuálnímu adresáři nebo úplný.Zpětné lomítko (\) nebo lomítko (/) lze jako oddělovač buď název adresáře.OpenFilePřeloží název oddělovače adresáře na odpovídající znaky před jeho 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