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

Вказівник на нульовим рядок, який містить ім'я файлу для отримання з FTP-сервер.

pstrLocalFile

Вказівник на нульовим рядок, який містить ім'я файлу для створення на локальній системі.

bFailIfExists

Вказує, чи ім'я файлу вже можуть бути використані на існуючий файл. Якщо ім'я локального файлу вже існує, і цей параметр вірно, не GetFile . В іншому випадку, GetFile призведе до видалення наявних копію файлу.

dwAttributes

Показує атрибути файлу. Це може бути будь-яка комбінація таких FILE_ATTRIBUTE_ * прапори.

• FILE_ATTRIBUTE_ARCHIVE   Файл — це файл архіву. Програми використовують цей атрибут для позначення файлів для резервного копіювання або видалення.
  
  
• FILE_ATTRIBUTE_COMPRESSED   Стиснутий файл або каталог. Файл стиснення означає, що всі дані у файл стискається. Для каталогів стиснення використовується за замовчуванням для новостворених та підтек.
  
  
• FILE_ATTRIBUTE_DIRECTORY   Файл є директорії.
  
  
• FILE_ATTRIBUTE_&NORMALnbsp;  Файл має ніяких інших атрибутів, встановити. Цей атрибут діє, лише якщо використовується тільки. Всі інші атрибути файлу перевизначити FILE_ATTRIBUTE_NORMAL:
  
  
• FILE_ATTRIBUTE_HIDDE&Nnbsp;  Файл приховано. Це не повинні бути включені в звичайних directory-список.
  
  
• FILE_ATTRIBUTE_READO&NLYnbsp;  Файл доступний лише для читання. Програми можна прочитати файл, але не може написати його або видалити його.
  
  
• FILE_ATTRIBUTE_SYSTEM   Файл є частиною або використовується виключно від операційної системи.
  
  
• FILE_ATTRIBUTE_TEMPORARY   Файл використовується для тимчасового зберігання даних. Програми повинні написати до файлу, лише якщо абсолютно необхідним. Більшість з файлу даних залишається в пам'яті без почервонів медіа оскільки файл незабаром буде видалено.

dwFlags

Визначення умов, за яких передача відбувається. Цей параметр може бути будь-який з dwFlags значеннями, які описані в FtpGetFile в Платформа 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