CFtpConnection::OpenFile

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

Wartość zwracany

Wskaźnik do obiektu CInternetFile.

Parametry

pstrFileName

Wskaźnik ciąg zawierający nazwę pliku, który ma być otwarty.

dwAccess

Określa, w jaki sposób plik będzie są dostępne. Może być GENERIC_READ lub GENERIC_WRITE, ale nie oba.

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_TRA&NSFER_TYPE_ASCIInbsp;  Przesyłanie plików za pomocą metody transferu FTP ASCII (typ A). Konwertuje kontroli i informacje o formatowaniu na lokalnym odpowiedniki.
  
  
• FTP_TRA&NSFER_TYPE_BINARYnbsp;  Plik przesyła dane przy użyciu FTP's obrazu (typ I) przenieść metody. Dane transfery plików dokładnie tak, jak go istnieje, bez żadnych zmian. Jest to domyślna metoda transferu.

dwContext

Identyfikator kontekstu do otwierania pliku. Aby uzyskać więcej informacji na temat dwContext , zobacz uwagi.

Uwagi

Wywołanie tej funkcji Państwa, aby otworzyć plik znajdujący się na serwerze FTP na odczyt lub zapis. OpenFile powinny być stosowane w następujących sytuacjach:

• Aplikacja ma dane, który musi być wysłane i utworzone jako plik na serwerze FTP, ale że danych nie jest w pliku lokalnym. Po OpenFile otwiera plik, aplikacja wykorzystuje CInternetFile::Write do wysyłania danych pliku FTP na serwerze.
  
  
• Aplikacja musi pobrać plik z serwera i umieścić go w pamięci kontrolowane przez aplikację, zamiast pisania go na dysku. Aplikacja używa CInternetFile::Read po użyciu OpenFile do otwarcia pliku.
  
  
• Aplikacja potrzebuje grzywny poziomu kontroli nad transferu plików. Na przykład, aplikacja może chcesz wyświetlić postęp kontroli wskazuje postęp stanu transferu pliku podczas pobierania pliku.

Po wywołaniu OpenFile i aż do wywoływania Zamknijaplikację może wywołać tylko CInternetFile::Read, CInternetFile::Write, Zamknijlub CFtpFileFind::FindFile. Wzywa do innych funkcji FTP dla tej samej sesji FTP będą się niepowodzeniem i ustawić kod błędu FTP_ETRANSFER_IN_PROGRESS.

Parametr pstrFileName może być albo częściowo kwalifikowaną nazwę pliku względem bieżącego katalogu lub w pełni kwalifikowaną. Odwróconej kreski ułamkowej (\) lub ukośnik (/) może służyć jako separatora katalogu dla każdej nazwy. OpenFile tłumaczy separatory nazwa katalogu na odpowiednie znaki przed użyciem go.

Zastąpić ustawienia domyślne dwContext , aby ustawić identyfikator kontekstu wartość Twój wybór. Identyfikator kontekstu jest skojarzony z tej konkretnej operacji obiekt CFtpConnection utworzone przez jej obiektu CInternetSession . Wartość jest zwracana do CInternetSession::OnStatusCallback zapewnienie stan operacji, z którym jest zidentyfikowany. Zobacz artykuł Pierwsze kroki w Internecie: WinInet uzyskać więcej informacji dotyczących identyfikatora kontekstu.

Omówienie CFtpConnection |nbsp; Klasa członków | Wykres hierarchii

Zobacz też CInternetConnection, CFtpConnection::GetFile, CGopherConnection::OpenFile, CInternetFile::Write, CInternetFile::Read