CFtpConnection::CFtpConnection

Статья
02/20/2013

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

CFtpConnection(
   CInternetSession* pSession,
   HINTERNET hConnected,
   LPCTSTR pstrServer,
   DWORD_PTR dwContext
);
CFtpConnection(
   CInternetSession* pSession,
   LPCTSTR pstrServer,
   LPCTSTR pstrUserName = NULL,
   LPCTSTR pstrPassword = NULL,
   DWORD_PTR dwContext = 0,
   INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER,
   BOOL bPassive = FALSE
);

Параметры

pSession
Указатель к связанному объекту CInternetSession.
hConnected
Маркер Windows текущего сеанса через интернет.
pstrServer
Указатель на строку, содержащую имя ftp-сервера.
dwContext
Идентификатор контекста для операции.dwContext задает сведения о состоянии операции, возвращаемые CInternetSession::OnStatusCallback.Значение по умолчанию равно 1; однако можно явно присвоить определенный идентификатор контекста для операции.Объект и любые его делает будут сопоставлены с таким идентификатором контекста
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 напрямую.Вместо этого вызовите CInternetSession::GetFtpConnection, который создает объект CFptConnection.