CFtpConnection * GetFtpConnection (LPCTSTR pstrServer, LPCTSTR pstrUserName = NULL, LPCTSTR pstrPassword = NULL, INTERNET_PORT nPort INTERNET_INVALID_PORT_NUMBER, BOOL = bPassive = FALSE);
Кинути (CInternetException);
Значення, яке повертається
Вказівник на об'єкт CFtpConnection . Якщо виклик не вдалося, визначити причину помилки, вивчаючи кинули CInternetException об'єкта.
Параметри
pstrServer
Вказівник на рядок, який містить ім'я сервера FTP.
pstrUserName
Вказівник на нульовим закінченням, який указує ім'я користувача увійти в систему. Якщо значення NULL, за замовчуванням є анонімною.
pstrPassword
Вказівник на нульовим закінченням, що визначає пароль для входу. Якщо pstrPassword і pstrUserName NULL, анонімного паролю за замовчуванням є ім'я користувача електронної пошти. Якщо pstrPassword є NULL (або пустий рядок), але pstrUserName не NULL, використовується порожній пароль. У нижченаведеній таблиці описано поведінка чотири можливих параметрів, pstrUserName і pstrPassword:
| pstrUserName | pstrPassword | Ім'я користувача, які надіслані до FTP-сервера | Пароль відправлений до FTP-сервера |
| Значення NULL або "" | Значення NULL або "" | "анонімні" | Ім'я користувача електронної пошти |
| Non-NULL рядок | Значення NULL або "" | pstrUserName | “ “ |
| NULL Non-NULL рядок | ПОМИЛКА | ПОМИЛКА | |
| Non-NULL рядок | Non-NULL рядок | pstrUserName | pstrPassword |
nPort
Число, яке ідентифікує TCP/IP порту для використання на сервері.
bPassive
Визначає пасивний або активний режим для цього сеансу FTP. Якщо значення TRUE, встановлює Win32 API dwFlag INTERNET_FLAG_PASSIVE.
Зауваження
Цю функцію член, щоб встановити підключення до FTP і отримати вказівник об'єкта CFtpConnection.
GetFtpConnection підключення до FTP-сервера і створює і повертає вказівник на об'єкт CFTPConnection . Він не виконує будь-якої конкретної операції на сервері. Якщо ви маєте намір читання або записування файлів, наприклад, ви повинні виконати ці операції як окремі кроки. Переглянути класи CFtpConnection та CFtpFileFind відомості пошук файлів, відкриття файлів і читання чи запису файлів. У статті Інтернеті програмування з WinInet в Visual C++ програміста керівництво для кроків у виконанні типових завдань підключення FTP.
Огляд CInternetSession |nbsp; Члени класу | Ієрархічна діаграма
Дивіться також CFtpConnection CInternetSession::GetGopherConnection, CInternetSession::GetHttpConnection, CInternetSession::OpenURL