Создает новый каталог на FTP-сервере.

Declare Integer FtpCreateDirectory In WinInet ;
   Integer nConnect_Handle, String @lpcDirectory

Параметры

nConnect_Handle
Хендл, полученный в результате вызова функции InternetConnect с использованием параметра nService, установленного в значение INTERNET_SERVICE_FTP (1)

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

Возвращаемые значение
 
В случае, если операция создания каталога завершилась успешно, то будет возвращен TRUE, ну и в противном случае, разумеется, FALSE. В случае ошибки, для получения характерного сообщения об ошибке, вызовите GetLastError. Если сообщение об ошибке показывает, что FTP-сервер отклонил запрос на создание каталога, вызовите функцию InternetGetLastResponseInfo для определения причины.

Примечания

Приложение должно использовать функцию FtpGetCurrentDirectory для определения текушего рабочего каталога, вместо того, чтобы подразумевать, что удаленная система использует иерархическую схему наименований для каталогов.

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

Удаляет файл, хранящийся на FTP-сервере.

Declare Integer FtpDeleteFile In WinInet ;
   Integer nConnect_Handle, String @lpcFileName

Параметры

nConnect_Handle
Хендл, полученный в результате вызова функции InternetConnect с использованием параметра nService, установленного в значение INTERNET_SERVICE_FTP (1)

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

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

В случае, если операция удаления файла завершилась успешно, то будет возвращен TRUE, ну и в противном случае, разумеется, FALSE. В случае ошибки, для получения характерного сообщения об ошибке, вызовите GetLastError.

Примечания

Параметр lpcFileName должен представлять из себя либо полностью квалифицированное имя файала, либо содержать путь, относительно текущего каталога.

Ищет указанный каталог в данной FTP сессии. Файл и каталог возвращаются приложению в виде структуру WIN32_FIND_DATA.

Declare Integer FtpFindFirstFile In WinInet ;
   Integer nConnect_Handle, String @lpcSearchStr, String @lpcWIN32_FIND_DATA, ;
   Integer nFlags, Integer nContext

Параметры

nConnect_Handle
Хендл, полученный в результате вызова функции InternetConnect с использованием параметра nService, установленного в значение INTERNET_SERVICE_FTP (1)

lpcSearchStr
Указатель на строку с нуль-терминатором, которая указывает действительный путь каталога или имя файла для файловой системы FTP-сервера. Строка может содержать модификаторы (*), однако в имени не допускаются пробелы. Если значение lpcSearchStrIf равно NULL или, если оно представляет собой пустую строку, функция ищет первый файл в текущем каталоге на сервере.

lpcWIN32_FIND_DATA
Указатель на структуру WIN32_FIND_DATA, которая получает информацию о найденном файле или каталоге. Структура приведена ниже:

WIN32_FIND_DATA {
   DWORD dwFileAttributes;  
   FILETIME ftCreationTime;  
   FILETIME ftLastAccessTime;  
   FILETIME ftLastWriteTime;  
   DWORD nFileSizeHigh;  
   DWORD nFileSizeLow;  
   DWORD dwReserved0;  
   DWORD dwReserved1;  
   TCHAR cFileName[MAX_PATH];  
   TCHAR cAlternateFileName[14];
}

Замечание. Не все файловые системы могут фиксировать время создания и последнего доступа к файлу в однообразной манере. Например, на NT FAT, время создания файла имеет разрешение в 10 миллисекунд, время записи - 2 секунды, а время доступа - 1 день (реально, дата доступа). На NTFS, время последнего доступа к файлу имеет разрешение в 1 час

nFlags
Управляет поведением этой функции. Этот параметр может комбинацией следующих значений:

• INTERNET_FLAG_HYPERLINK (0x00000400)
• INTERNET_FLAG_NEED_FILE (0x00000010)
• INTERNET_FLAG_NO_CACHE_WRITE (0x04000000)
• INTERNET_FLAG_RELOAD (0x80000000)
• INTERNET_FLAG_RESYNCHRONIZE (0x00000800)

nContext
Указатель на переменную, которая определяет определенное приложением значение, которая связывает этот поиск я любыми данными приложения. Этот параметр используется только в том случае, если приложение уже вызвало InternetSetStatusCallback для установки статуса callback функции.

Возвращаемые значение
 
Возвращает действительный хэндл к запросу, если перечисление каталога началось успешно, в противно случае возвращает NULL. Для получения характерного для этой функции сообщения об ошибке, вызовите GetLastError. Если GetLastError возвращает ERROR_INTERNET_EXTENDED_ERROR (12003), как в случае, если функция не нашла файла, отвечающего запрошенному, вызовите функцию InternetGetLastResponseInfo для получения расширенного текста ошибки, как это было уже показано ранее в примерах.

Примечания

Для функции FtpFindFirstFile, параметры файла, связанные со временем, возврщаемые в структуре WIN32_FIND_DATA указываются в местной временной зоне, а не в формате координированного универсального времени (UTC).

Функция FtpFindFirstFile схожа с функцией FindFirstFile. Отметьте, однако, что только одна функция FtpFindFirstFile может быть вызвана во время данной FTP сессии. Перечисления (enumerations), поэтому, скоррелированы с хэндлом FTP сессии. Это вызвано тем, что протокол FTP допускает только одно перечисление каталога на сессию.

После вызова функции FtpFindFirstFile и до момента вызова InternetCloseHandle, приложение не может вызвать FtpFindFirstFile повторно на данном хэндле FTP сессии. Если повторный вызов FtpFindFirstFile все-таки сделан на этом хэндле, функция завершается с ошибкой ERROR_FTP_TRANSFER_IN_PROGRESS (12110). При завершении приложения, использовавшего хэндл, возвращенный вызовом FtpFindFirstFile, оно должно закрыть его с помощью вызова функции InternetCloseHandle.

После успешного начала перечисления каталога с помощью функции FtpFindFirstFile, для продолжения перечисления может быть использована функция InternetFindNextFile.

Поскольку протокол FTP не предоставляет стандартных средств перечисления (enumerating), кое-что и общей информации о файлах, такое как времена создания и доступа могут быть не всегда доступны или корректны. Когда это случается, FtpFindFirstFile и InternetFindNextFile заполняют места недоступной информации предположительным подсчетом на основе другой доступной информации. Например, даты создания и последнего доступа часто такие же, как и дата изменения файла.

Приложение не может вызвать функцию FtpFindFirstFile между вызовами функций FtpOpenFile и InternetCloseHandle.

Продолжает поиск файла, начиная с результата, полученного в результате предудыщего вызова FtpFindFirstFile или GopherFindFirstFile.

Declare Integer InternetFindNextFile In WinInet ;
   Integer nConnect_Handle, String @lpcWIN32_FIND_DATA

Параметры

nConnect_Handle
 
Хендл, полученный в результате вызова функции InternetConnect.

lpcWIN32_FIND_DATA
 
Указатель на буффер, (для FTP - это структура WIN32_FIND_DATA), который получает информацию о найденном файле или каталоге. (Структура приведена в описании предыдущей функции - FtpFindFirstFile). Поскольку Gopher не представляет интереса в этом цикле статей, я его и не рассматриваю). В случае протокола Gopher используется структура GOPHER_FIND_DATA.

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

Возвращает TRUE, если вызов завершился успешно, в противном случае FALSE. Для получения расширенной информации об ошибке вызовите GetLastError. Если функция не нашла соответствующего файла, то GetLastError вернет ERROR_NO_MORE_FILES.

Возвращает информацию о текущем каталоге для данной FTP-сессии.

Declare Integer FtpGetCurrentDirectory In WinInet ;
   Integer nConnect_Handle, String @lpcDirectory, Integer @nMax_Path

Параметры

nConnect_Handle

 
Хендл, полученный в результате вызова функции InternetConnect.

lpcDirectory

 
Указатель на строку с нуь-терминатором, которая получит абсолютный путь текущего каталога.

nMax_Path

 
Указательна переменную, которая определяет длину буффера в TCHARs. Длина буффера должна учитывать пространство для символа нуль-терминатора (CHR(0)). Использование длины MAX_PATH (INTERNET_MAX_PATH_LENGTH 2048 ??) достаточно для всех путей. При возврате функция заполняет переменную числом, определяющим количество символов, записанных в буффер.

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

Возвращает TRUE, если вызов завершился успешно, в противном случае FALSE. Для получения расширенной информации об ошибке вызовите GetLastError.

Примечания

Если буффер lpcDirectory недостаточно велик, в nMax_Path будет записано число байтов, требуемых для сохранения полного имени текущего каталога.

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

Declare Integer FtpGetFile In WinInet ;
   Integer nConnect_Handle, String @lpcRemoteFile, String @lpcNewFile, ;
   Integer nFailIfExists, Integer nAttributes, Integer nFlags, ;
   Integer nContext

Параметры

nConnect_Handle

 
Хэндл к FTP-сессии.(Смотри описания выше)

lpcRemoteFile

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

lpcNewFile

 
Указатель на строку с нуль-терминатором, которая содержит имя файла, который будет создан на локальной системе.

nFailIfExists

 
Указывает, должна-ли функция выполнять операцию, если локальный файл с указанным именем уже существует. Если параметр установлен в TRUE и локальный файл уже существует функция завершится с ошибкой.

nAttributes

 
Аттрибуты для нового файла. Этот параметр может быть комбинацией флагов FILE_ATTRIBUTE_*, используемых функцией WinAPI CreateFile.

nFlags

 
Управляет тем, как функция будет обрабатывать загрузку с сервера. Первый набор значений флага указывает условия, при которых происходит перенос файла. Эти флаги типа транспорта могут быть использованы в комбинации со вторым набором значений, который управляет кэшированием.>
Приложение может выбрать одно из значений этих типов переноса файла на локальную систему.

Приведенные ниже флаги определяют - как будет производиться кэширование этого файла. Любая комбинация из приведенных ниже флагов может быть использована с флагом типа переноса файла.

nContext

 
Указатель на переменную, которая определяет определенное приложением значение, которая связывает этот поиск я любыми данными приложения. Этот параметр используется только в том случае, если приложение уже вызвало InternetSetStatusCallback для установки статуса callback функции.

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

Возвращает TRUE, если вызов завершился успешно, в противном случае FALSE. Для получения расширенной информации об ошибке вызовите GetLastError.

Примечания

FtpGetFile представляет собой процедуру высокого уровня, которая обрабатывает все подсчеты и накладные расходы, связанные с чтением файла из FTP-сервера и сохранением его локально. Приложение, которому нужны только данные о файле, или которому нужен больший контроль над переносом файла, должно использовать функции FtpOpenFile и InternetReadFile.

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

Оба, и lpcRemoteFile, и lpcNewFile имени могут иметь частично или полностью квалифицированные имена относительно текущего каталога.

Инициирует доступ к удаленному файлу на FTP-сервере для чтения или записи.

Declare Integer FtpOpenFile In WinInet ;
   Integer nConnect_Handle, String @lpcRemoteFile, Integer nAccessType, ;
   Integer nFlags, Integer nContext

Параметры

nConnect_Handle

 
Хэндл к FTP-сессии.(Смотри описания выше)

lpcRemoteFile

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

nAccessType

 
Тип доступа к файлу. Этот параметр может принимать значение GENERIC_READ (0x80000000) или GENERIC_WRITE (0x40000000),но не оба.

nFlags

 
Смотри описание предыдущей функции - FtpGetFile

nContext

 
Указатель на переменную, которая определяет определенное приложением значение, которая связывает этот поиск я любыми данными приложения. Этот параметр используется только в том случае, если приложение уже вызвало InternetSetStatusCallback для установки статуса callback функции.

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

Возвращает хэндл файла, если вызов завершился успешно, в противном случае NULL. Для получения расширенной информации об ошибке вызовите GetLastError.

Примечания

После вызова функции FtpOpenFile и до вызова InternetCloseHandle, все другие вызовы FTP функций на том же самом хэндле FTP сессии будут завершаться с ошибкой и устанавливать сообщение об ошибке в ERROR_FTP_TRANSFER_IN_PROGRESS (12110). При завершении приложения, которое использовало хендл, полученный в результате вызова FtpOpenFile, он должен быть закрыт приложением с помощью функции InternetCloseHandle.

В течение одной FTP сесии может быть открыт только один файл..

Параметр lpcRemoteFile может быть частично или полностью квалифицированным именем относительно текущего каталога.

Declare Integer FtpPutFile In WinInet ;
   Integer nConnect_Handle, String @lpcLocalFile, String @lpcNewRemoteFile, ;
   Integer nFlags, Integer nContext

Параметры

nConnect_Handle

 
Хэндл к FTP-сессии.(Смотри описания выше)

lpcLocalFile

 
Указатель на строку с нуль-терминатором, которая содержит имя файла, который будет послан с локальной системы на удаленную систему (FTP сервер).

lpcNewRemoteFile

 
Указатель на строку с нуль-терминатором, которая содержит имя файла, который будет создан на удаленной системе.

nFlags

 
Смотри описание функции FtpGetFile

nContext

 
Указатель на переменную, которая определяет определенное приложением значение, которая связывает этот поиск я любыми данными приложения. Этот параметр используется только в том случае, если приложение уже вызвало InternetSetStatusCallback для установки статуса callback функции.

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

Возвращает TRUE, если вызов завершился успешно, в противном случае FALSE. Для получения расширенной информации об ошибке вызовите GetLastError.

Примечания

FtpPutFile представляет собой процедуру высокого уровня, которая обрабатывает все подсчеты и накладные расходы, связанные с чтением файла на локальной системе и сохранением его на FTP-сервере. Приложение, которому нужны только данные о файле, или которому нужен больший контроль над переносом файла, должно использовать функции FtpOpenFile и InternetReadFile.

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

Оба, и lpcNewRemoteFile, и lpcLocalFile имени могут иметь частично или полностью квалифицированные имена относительно текущего каталога.

Declare Integer FtpRemoveDirectory In WinInet ;
   Integer nConnect_Handle, String @lpcDirectory

Параметры

nConnect_Handle

 
Хэндл FTP сессии (смотри описания выше)

lpcDirectory

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

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

Возвращает TRUE, если вызов завершился успешно, в противном случае FALSE. Для получения расширенной информации об ошибке вызовите GetLastError. Если сообщение об ошибке указывает, что FTP-сервер отклонил запрос на удаление каталога, вызовите функцию InternetGetLastResponseInfo для определения причины.

Примечания

Приложение должно использовать функцию FtpGetCurrentDirectory для определения текущего каталога удаленного сайта, вместо того, чтобы подразумевать, что удаленная система использует иерархическую схему наименований для каталогов.

Параметр lpcDirectory может быть как частично, так и полностью квалифицированным именем относительно текущего каталога.

Переименовывает файл, хранящийся на FTP сервере.

Declare Integer FtpRenameFile In WinInet ;
   Integer nConnect_Handle, String @lpcRemoteFile, String @lpcNewFile

Параметры

nConnect_Handle

 
Хэндл FTP сессии

lpcRemoteFile

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

lpcNewFile

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

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

Возвращает TRUE, если вызов завершился успешно, в противном случае FALSE. Для получения расширенной информации об ошибке вызовите GetLastError.

Примечания

Оба, и lpcRemoteFile, и lpcNewFile имени могут иметь частично или полностью квалифицированные имена относительно текущего каталога.

Declare Integer FtpSetCurrentDirectory In WinInet ;
   Integer nConnect_Handle, String @lpcDirectory

Параметры

nConnect_Handle

 
Хэндл FTP сессии

lpcDirectory

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

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

Возвращает TRUE, если вызов завершился успешно, в противном случае FALSE. Для получения расширенной информации об ошибке вызовите GetLastError. Если сообщение об ошибке указывает, что FTP-сервер отклонил запрос на изменение текущего каталога, вызовите функцию InternetGetLastResponseInfo для определения причины.

Примечания

Приложение должно использовать функцию FtpGetCurrentDirectory для определения текущего каталога удаленного сайта, вместо того, чтобы подразумевать, что удаленная система использует иерархическую схему наименований для каталогов.

Параметр lpcDirectory может быть как частично, так и полностью квалифицированным именем относительно текущего каталога.