CFtpConnection::OpenFile

Artykuł
02/27/2013

Wywołanie tej funkcji Członkowskich, aby otworzyć plik znajdujący się na serwerze FTP do czytania lub pisania.

CInternetFile* OpenFile(
   LPCTSTR pstrFileName,
   DWORD dwAccess = GENERIC_READ,
   DWORD dwFlags = FTP_TRANSFER_TYPE_BINARY,
   DWORD_PTR dwContext = 1 
);

Parametry

pstrFileName
Wskaźnik ciąg zawierający nazwę pliku do otwarcia.
dwAccess
Określa, jak plik będzie dostępny.Może być GENERIC_READ lub GENERIC_WRITE, ale nie obu.
dwFlags
Określa warunki, w jakich występują następnych transferów.Może to być dowolny z następujących stałych FTP_TRANSFER_ *:
- FTP_TRANSFER_TYPE_ASCII plik przesyła przy użyciu metody transferu FTP ASCII (typ A).Formant konwertuje i informacje o formatowaniu na lokalne odpowiedniki.
- FTP_TRANSFER_TYPE_BINARY pliku, transfery danych przy użyciu metody transferu obrazów z FTP's, (typ I).Plik transfery danych dokładnie tak, jak istnieje bez żadnych zmian.To jest domyślna metoda transferu.
dwContext
Identyfikator kontekstu otwarcie pliku.Zobacz uwagi uzyskać więcej informacji o dwContext.

Wartość zwracana

Wskaźnik do CInternetFile obiektu.

Uwagi

OpenFilenależy używać w następujących sytuacjach:

Aplikacja ma danych musi być wysłana i utworzony jako plik na serwerze FTP, ale że danych nie jest plikiem lokalnym.Po OpenFile otwiera plik, aplikacja używa CInternetFile::Write do wysłania do serwera FTP dane pliku.
Aplikacja musi pobrać plik z serwera i ją umieścić w pamięci kontrolowane przez aplikację, zamiast zapisywania dysku.Aplikacja używa CInternetFile::Read po użyciu OpenFile do otwarcia pliku.
Aplikacja musi fine poziom kontroli nad transferu plików.Na przykład, aplikacja może chcesz wyświetlić postęp kontroli wskazuje postęp stan transferu pliku podczas pobierania pliku.

Po wywołaniu OpenFile i do momentu wywołania CInternetConnection::Close, aplikacja może wywołać tylko CInternetFile::Read, CInternetFile::Write, CInternetConnection::Close, lub CFtpFileFind::FindFile.Wywołania funkcji FTP, inne w tej samej sesji FTP będzie się niepowodzeniem i ustaw kod błędu FTP_ETRANSFER_IN_PROGRESS.

pstrFileName Parametr może być albo częściowo kwalifikowana nazwa pliku względem bieżącego katalogu lub w pełni kwalifikowana.Jako separatora katalogu dla każdej nazwy można odwróconej kreski ułamkowej (\) lub ukośnik (/).OpenFiletłumaczy separatory nazwa katalogu na odpowiednie znaki przed jej użyciem.

Zastąpić dwContext domyślne, aby ustawić identyfikator kontekstu wartość wybrane.Identyfikator kontekstu jest skojarzony z tym działania związane z CFtpConnection obiekt utworzony przez jego CInternetSession obiektu.Wartość jest zwracana do CInternetSession::OnStatusCallback zapewnienie stan operacji, z którym jest identyfikowana.Zobacz artykuł pierwsze kroki Internet: WinInet uzyskać więcej informacji dotyczących identyfikatora kontekstu.