CGopherConnection::CGopherConnection

Статья
06/10/2015

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

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

Параметры

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 для использования на сервере.

Заметки

Никогда не создаются CGopherConnection напрямую. Вместо этого вызовите CInternetSession::GetGopherConnection, который создает и возвращает объект CGopherConnection указатель на него.