CInternetSession::GetFtpConnection

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 или "" «Анонимный» Имя пользователя электронной почты
Не-НУЛЕВАЯ строка Значение NULL или "" pstrUserName “ “
Значение 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

Index