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_ *.

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

Index