CFtpConnection::GetFile

BOOL GetFile (LPCTSTR pstrRemoteFile, LPCTSTR pstrLocalFile, BOOL bFailIfExists = TRUE, DWORD dwAttributes = FILE_ATTRIBUTE_NORMAL, DWORD dwFlags = FTP_TRANSFER_TYPE_BINARY, DWORD dwContext = 1);

Wartość zwracany

Niezerowa, jeśli kończy się pomyślnie; przeciwnym razie 0. Jeśli wezwanie się nie powiedzie, funkcji Win32 GetLastError może być wywołana aby ustalić przyczynę błędu.

Parametry

pstrRemoteFile

Wskaźnik ciąg zakończony zerem, zawierający nazwę pliku do pobrania z serwera FTP.

pstrLocalFile

Wskaźnik ciąg zakończony zerem, zawierający nazwę pliku, aby utworzyć w systemie lokalnym.

bFailIfExists

Wskazuje, czy nazwa pliku może już używane przez istniejącego pliku. Jeśli nazwa lokalnego pliku już istnieje, a ten parametr ma wartość TRUE, GetFile kończy się niepowodzeniem. W przeciwnym razie GetFile wymazuje istniejącą kopię pliku.

dwAttributes

Wskazuje atrybuty pliku. Może to być dowolna kombinacja następujących flag FILE_ATTRIBUTE_ *.

• FILE_ATTRIBUTE_ARCHIVE   Plik jest plikiem archiwum. Aplikacje używają tego atrybutu do oznaczenia pliki kopii zapasowej lub usuwania.
  
  
• FILE_ATTRIBUTE_COMPRESSED   Plik lub katalog jest skompresowany. Dla pliku Kompresja oznacza, że wszystkie dane w pliku jest skompresowany. Dla katalogu kompresja jest domyślną wartością dla nowo utworzonych plików i podkatalogów.
  
  
• FILE_ATTRIBUTE_DIRECTORY   Plik jest katalogiem.
  
  
• FILE_ATTRIBUTE_&NORMALnbsp;  Plik ma nie inne ustawione atrybuty. Ten atrybut jest prawidłowy tylko wtedy, gdy użyty samodzielnie. Wszystkie inne atrybuty pliku zastąpić FILE_ATTRIBUTE_NORMAL:
  
  
• FILE_ATTRIBUTE_HIDDE&Nnbsp;  Plik jest ukryty. To nie mają zostać uwzględnione w wykazie zwykłych katalogu.
  
  
• FILE_ATTRIBUTE_READO&NLYnbsp;  Plik jest tylko do odczytu. Aplikacje mogą odczytywać plik, ale nie możesz w nim zapisywać lub go usunąć.
  
  
• FILE_ATTRIBUTE_SYSTEM   Plik jest częścią lub jest używane wyłącznie przez system operacyjny.
  
  
• FILE_ATTRIBUTE_TEMPORARY   Plik jest używany do składowania czasowego. Wnioski należy zapisywać do pliku tylko, jeśli jest to absolutnie konieczne. Większość danych plik pozostaje w pamięci bez jest opróżniany do nośnika, ponieważ plik zostanie usunięty, wkrótce.

dwFlags

Określa warunki, w jakich występuje transferu. Ten parametr może być dowolny z wartości dwFlags , opisane w FtpGetFile w zestawie SDK platformy.

dwContext

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

Uwagi

Nazwać tę funkcję Państwa, aby pobrać plik z serwera FTP i zapisać go na komputerze lokalnym.

GetFile jest wysokiego szczebla rutynowych, który obsługuje wszystkie nakład pracy związany z odczytu pliku z serwera FTP i zapisując go lokalnie. Wnioski, że tylko pobieranie pliku danych, lub które wymagają ścisłej kontroli nad transfer plików, zamiast przykładać OpenFile i CInternetFile::Read.

Jeśli dwFlags jest FILE_TRANSFER_TYPE_ASCII, tłumaczenia danych pliku także konwertuje kontroli i formatowania znaków Windows odpowiedniki. Transfer domyślnym jest trybie binarnym, gdzie plik jest pobierany w tym samym formacie, jak jest on przechowywany na serwerze.

PstrRemoteFile i pstrLocalFile może być albo częściowo kwalifikowanej nazwy 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. GetFile tłumaczy separatory nazwa katalogu na odpowiednie znaki, zanim zostaną użyte.

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