CInternetSession::GetFtpConnection

Статья
06/10/2015

Эта функция-член вызывается, чтобы установить соединение с FTP и получить указатель на объект CFtpConnection.

CFtpConnection* GetFtpConnection( 
   LPCTSTR pstrServer, 
   LPCTSTR pstrUserName = NULL, 
   LPCTSTR pstrPassword = NULL, 
   INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER, 
   BOOL bPassive = FALSE  
);

Параметры

pstrServer
Указатель на строку, содержащую имя ftp-сервера.
pstrUserName
Указатель на null- завершенной строку, определяющую имя пользователя для входа. Если NULL значение по умолчанию anonymous.

pstrPassword
Указатель на null- завершенной строке, которая указывает пароль для имени входа. Если и pstrPassword и pstrUserNameNULL, то по умолчанию анонимный пароль имя учетной записи электронной почты пользователя. Если pstrPasswordNULL (пустая строка), но не NULL, pstrUserName использоваться пустой пароль. Следующая таблица описывает расширение функциональности для 4 возможных параметров pstrUserName и pstrPassword:

pstrUserName	pstrPassword	Имя пользователя, отправляемые сервером ftp	Пароль, отправленный с ftp-сервера
NULL или ""	NULL или ""	"anonymous"	Имя электронной почты пользователя
Строка,NULL	NULL или ""	pstrUserName	" "
Строка NULL подписчиков, отличных от NULL	ОШИБКА	ОШИБКА
Строка,NULL	Строка,NULL	pstrUserName	pstrPassword

nPort
Число, задающее порт TCP/IP для использования на сервере.
bPassive
Задает пассивный или активный режим для данного сеанса. Если задано значение TRUE, оно присвоит Win32 API dwFlag к INTERNET_FLAG_PASSIVE.

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

Указатель на объект CFtpConnection. Если вызов завершается неудачей, определите причину сбоя с CInternetException штриховой объект.

Заметки

GetFtpConnection подключается к ftp-серверу, и создает и возвращает указатель на объект CFTPConnection. Он не выполняет никаких конкретную операцию на сервере. Если планируется выполнять чтение и запись в файлы, например, необходимо выполнить такие операции как отдельные шаги. См. классы CFtpConnection и CFtpFileFind дополнительные сведения о поиск файлов, файлов, и чтение или запись в файлы. См. статью Устройств, используемые при программировании с WinInet для шагов для выполнения общих задач соединения по протоколу FTP.