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

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