↑  ←  Описание функции


_FTP_FindFileFirst

Найти первый файл на FTP сервере.

#include <FTPEx.au3>
_FTP_FindFileFirst($l_FTPSession, $s_RemotePath, ByRef $h_Handle [, $l_Flags = 0 [, $l_Context = 0]])

Параметры

$l_FTPSession Указатель возвращённый функцией _FTP_Connect().
$s_RemotePath Путь, который будет использоваться при поиске файла.
$h_Handle Указатель возвращённый функцией _FTP_FindFileNext() или _FTP_FindFileClose().
$l_Flags [необязательный] Смотрите примечания.
$l_Context [необязательный] A variable that contains the application-defined value that associates this search with any application data.
This is only used if the application has already called _FTP_SetStatusCallback() to set up a status callback function.

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

Успех:Возвращает массив, смотрите примечания.
Ошибка:Возвращает 0 и устанавливает @error

Примечания

При успешном возвращении массива:
[0] - Количество элементов
[1] - Атрибуты файла
[2] - Время создания Low
[3] - Время создания Hi
[4] - Время доступа Low
[5] - Время доступа Hi
[6] - Последняя запись Low
[7] - Последняя запись Hi
[8] - Размер файла High
[9] - Размер файла Low
[10] - Имя файла
[11] - Altername

$l_Flags может быть комбинацией из $INTERNET_FLAG_HYPERLINK, $INTERNET_FLAG_NEED_FILE, $INTERNET_FLAG_NO_CACHE_WRITE, $INTERNET_FLAG_RELOAD, $INTERNET_FLAG_RESYNCHRONIZE

См. также

_FTP_FindFileNext, _FTP_FindFileClose, _FTP_SetStatusCallback

См. также

Искать FtpFindFirstFile в библиотеке MSDN

Пример

#include <FTPEx.au3>

Local $server = 'ftp.csx.cam.ac.uk'
Local $username = ''
Local $pass = ''

Local $Open = _FTP_Open('MyFTP Control')
Local $Conn = _FTP_Connect($Open, $server, $username, $pass)

Local $h_Handle
Local $aFile = _FTP_FindFileFirst($Conn, "/pub/software/programming/pcre/", $h_Handle)
ConsoleWrite('$Filename = ' & $aFile[10] & ' attribute = ' & $aFile[1] & '  -> Error code: ' & @error & @CRLF)

Local $FindClose = _FTP_FindFileClose($h_Handle)

Local $Ftpc = _FTP_Close($Open)