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);

Возвращаемое значение

Ненулевое значение, если успешно; в противном случае 0. Если не удается, функции Win32 GetLastError может быть вызвана для определения причины ошибки.

Параметры

pstrRemoteFile

Указатель на ограниченную значением null строку, содержащую имя файла, чтобы извлечь с сервера FTP.

pstrLocalFile

Указатель на ограниченную значением null строку, содержащую имя файла для создания в локальной системе.

bFailIfExists

Указывает ли имя файла может быть использован уже существующего файла. Если имя локального файла уже существует, и этот параметр имеет значение TRUE, не GetFile . В противном случае GetFile удалит существующую копию файла.

dwAttributes

Указывает атрибуты файла. Это может быть любое сочетание следующих флагов FILE_ATTRIBUTE_ *.

FILE_ATTRIBUTE_ARCHIVE Этот файл представляет собой файл архива. Приложения используют этот атрибут для обозначения файлов для резервного копирования или удаления.
FILE_ATTRIBUTE_COMPRESSED Файл или каталог сжат. Для файла сжатие означает, что все данные в файле сжимается. Для каталога сжатие выполняется по умолчанию для вновь создаваемых файлов и подкаталогов.
FILE_ATTRIBUTE_DIRECTORY Этот файл представляет собой каталог.
FILE_ATTRIBUTE_&NORMALnbsp; Этот файл имеет другие атрибуты не установлены. Этот атрибут действителен, только если используется отдельно. Все остальные атрибуты файла переопределить FILE_ATTRIBUTE_NORMAL:
FILE_ATTRIBUTE_HIDDE&Nnbsp; Файл скрыт. Это не включается в обычный вывод каталога.
FILE_ATTRIBUTE_READO&NLYnbsp; Этот файл доступен только для чтения. Приложения могут читать файл, но не может записать в него или удалить его.
FILE_ATTRIBUTE_SYSTEM Этот файл является частью или используется исключительно операционной системы.
FILE_ATTRIBUTE_TEMPORARY Этот файл используется для временного хранения. Приложения должны записать в файл только в случае крайней необходимости. Большая часть данных файла остается в памяти без сброшены СМИ потому, что вскоре этот файл будет удален.

dwFlags

Определяет условия, при которых происходит передача. Этот параметр может быть любым из значений dwFlags , описанных в FtpGetFile в Platform SDK.

dwContext

Идентификатор контекста для извлечения файла. Замечания более подробная информация о dwContext.

Примечания

Вызов этой функции-члена для получения файла с FTP-сервера и сохранить его на локальном компьютере.

GetFile является режима высокого уровня, который обрабатывает все накладные расходы, связанные с чтением файла с FTP-сервера и сохранение его локально. Приложения, которые только извлечение файлов данных, или которые требуют тесного контроля за передачей файлов, вместо него следует использовать OpenFile и CInternetFile::Read.

Если dwFlags FILE_TRANSFER_TYPE_ASCII, перевод файла данных также преобразует элемент управления и символы форматирования Windows эквиваленты. По умолчанию передаются бинарный режим, где этот файл загружается в том виде, как она хранится на сервере.

PstrRemoteFile и pstrLocalFile может быть либо частично квалифицированные имена файлов относительно текущего каталога или полное. Обратная косая черта (\) или косой черты (/) может использоваться в качестве разделителя каталогов для любого имени. GetFile переводит сепараторы имя директории в соответствующие символы до того, как они используются.

Переопределите значение по умолчанию dwContext для задания контекста идентификатора значение вашего выбора. Идентификатор контекста ассоциируется с этой конкретной операции CFtpConnection объект, созданный с его CInternetSession объект. Значение возвращается CInternetSession::OnStatusCallback предоставить статус операции, с которыми она идентифицируется. В статье Интернет первые шаги: WinInet для получения дополнительных сведений о контексте идентификатор.

Обзор CFtpConnection |nbsp; Члены класса | Иерархическая схема

См. также CInternetConnection

Index