CFtpConnection::GetFile
Wywołanie tej funkcji Członkowskich pobieranie pliku z serwera FTP i przechowywać go na komputerze lokalnym.
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
Wskaźnik na ciąg zakończony znakiem null, zawierające nazwę pliku do pobrania z serwera FTP.pstrLocalFile
Wskaźnik na ciąg zakończony znakiem null, zawierające 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 i jest to parametr TRUE, GetFile nie powiedzie się.W przeciwnym razie GetFile spowoduje usunięcie istniejących kopii pliku.dwAttributes
Określa atrybuty pliku.Może to być dowolna kombinacja następujących flag FILE_ATTRIBUTE_ *.Plik FILE_ATTRIBUTE_ENCRYPTED jest plik archiwum.Aplikacje oznaczania plików kopii zapasowej lub usuwanie za pomocą tego atrybutu.
FILE_ATTRIBUTE_COMPRESSED plik lub katalog jest skompresowany.Dla pliku Kompresja oznacza wszystkie dane w pliku jest skompresowany.Dla katalogu kompresji jest domyślne dla nowo utworzonych plików i podkatalogów.
FILE_ATTRIBUTE_DIRECTORY plik jest katalogiem.
Plik nie ma ustawionych żadnych innych atrybutów.Ten atrybut jest prawidłowy tylko wtedy, gdy użyty samodzielnie.Inne atrybuty pliku zastąpić FILE_ATTRIBUTE_NORMAL:
FILE_ATTRIBUTE_HIDDEN plik jest ukryty.Jest nie mają zostać uwzględnione w katalogu zwykłych aukcji.
Plik FILE_ATTRIBUTE_READONLY jest tylko do odczytu.Aplikacje można odczytać pliku, ale nie można w nim zapisywać lub usuń je.
FILE_ATTRIBUTE_SYSTEM plik jest częścią lub jest używany wyłącznie przez system operacyjny.
FILE_ATTRIBUTE_TEMPORARY plik jest używany do tymczasowego przechowywania.Aplikacje należy zapisać do pliku tylko wtedy, gdy jest to absolutnie konieczne.Większość danych plik pozostanie w pamięci bez opróżniane nośnika, ponieważ plik wkrótce zostanie usunięty.
dwFlags
Określa warunki, w których występuje transferu.Ten parametr może być dowolny z dwFlags wartości opisane w FtpGetFile w Windows SDK.dwContext
Identyfikator kontekstu pobierania pliku.Zobacz uwagi uzyskać więcej informacji o dwContext.
Wartość zwracana
Niezerowa, jeśli kończy się pomyślnie; 0 inaczej.Jeżeli połączenie nie powiedzie się, funkcja Win32 GetLastError mogą być nazywane, aby ustalić przyczynę błędu.
Uwagi
GetFilejest procedura wysokiego szczebla, która obsługuje wszystkie obciążenia związanego z odczytu pliku z serwera FTP i przechowywanie go lokalnie.Należy użyć aplikacji pobrać tylko dane z pliku lub które wymagają ścisłej kontroli nad transferu plików, OpenFile i CInternetFile::Read zamiast.
Jeśli dwFlags FILE_TRANSFER_TYPE_ASCII, tłumaczenie danych z pliku jest także formant konwertuje i formatowanie znaków Windows odpowiedniki.Transfer domyślny jest binarny tryb, gdzie pobrany plik w formacie przechowywanej na serwerze.
Obie pstrRemoteFile i pstrLocalFile może być albo częściowo kwalifikowanej nazwy względem bieżącego katalogu lub w pełni kwalifikowaną.Jako separatora katalogu dla każdej nazwy można odwróconej kreski ułamkowej (\) lub ukośnik (/).GetFiletłumaczy separatory nazwa katalogu na odpowiednie znaki, zanim zostaną użyte.
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.
Wymagania
Nagłówek: afxinet.h