CFtpConnection::OpenFile

CInternetFile * OpenFile (LPCTSTR pstrFileName, DWORD dwAccess = GENERIC_READ, DWORD dwFlags = FTP_TRANSFER_TYPE_BINARY, DWORD dwContext = 1);

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

Указатель на объект CInternetFile.

Параметры

pstrFileName

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

dwAccess

Определяет, каким образом будет доступа к файлу. Может быть либо GENERIC_READ или GENERIC_WRITE, но не оба.

dwFlags

Определяет условия, при которых происходят последующих переводов. Это может быть любой из следующих констант FTP_TRANSFER_ *:

• FTP_TRA&NSFER_TYPE_ASCIInbsp;  Файл переводов с помощью метода переноса FTP ASCII (тип A). Преобразует элемент управления и сведения о форматировании в местные эквиваленты.
  
  
• FTP_TRA&NSFER_TYPE_BINARYnbsp;  Перенос данных с помощью файлов FTP's (тип I) передачи изображения методом. Файл передачи данных точно так же, как она существует, без изменений. Это метод передачи по умолчанию.

dwContext

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

Примечания

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

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

После вызова метода OpenFile и до вызова тесныеприложение может только вызывать CInternetFile::Read, CInternetFile::Write, близкиеили CFtpFileFind::FindFile. Вызовы других функций FTP на той же сессии FTP не и задайте код ошибки FTP_ETRANSFER_IN_PROGRESS.

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

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

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

См. также CInternetConnection, CFtpConnection::GetFile, CGopherConnection::OpenFile, CInternetFile::Write, CInternetFile::Read