CGopherConnection::CGopherConnection

Artigo
08/25/2010

Essa função de membro é chamada para construir um CGopherConnection objeto.

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
);

Parâmetros

pSession
Um ponteiro para o relacionado CInternetSession objeto.
hConnected
O identificador do Windows da corrente sessão Internet.
pstrServer
Um ponteiro para uma seqüência de caracteres que contém o nome do servidor FTP.
dwContext
O identificador de contexto para a operação.dwContext identifica as informações de status da operação retornadas por CInternetSession::OnStatusCallback.O padrão é definido como 1; no entanto, você pode atribuir explicitamente uma ID de contexto específico para a operação.O objeto e qualquer trabalho que será associados a essa ID de contexto.
pstrUserName
Ponteiro para uma seqüência de caracteres terminada com nulo que especifica o nome do usuário para log no.If NULO, o padrão é anônimo.

pstrPassword
Um ponteiro para uma seqüência de caracteres terminada com nulo que especifica a senha a ser usada para efetuar login.Se ambos os pstrPassword e pstrUserName são NULO, a senha anônima padrão é o nome do email.If pstrPassword é NULO (ou uma seqüência vazia), mas pstrUserName não é NULO, uma senha em branco é usado.A tabela a seguir descreve o comportamento para as quatro configurações possíveis pstrUserName e pstrPassword:

pstrUserName	pstrPassword	Nome de usuário enviado ao servidor FTP	Senha enviada ao servidor FTP
NULOor " "	NULOor " "	"anônimo"	Nome de email do usuário
Non-NULO Seqüência de caracteres	NULOor " "	pstrUserName	" "
NULO Non-NULO Seqüência de caracteres	ERRO	ERRO
Non-NULO Seqüência de caracteres	Non-NULO Seqüência de caracteres	pstrUserName	pstrPassword

nPort
Um número que identifica a porta TCP/IP para usar no servidor.

Comentários

Você nunca criar um CGopherConnection diretamente. Em vez disso, chama CInternetSession::GetGopherConnection, que cria um CGopherConnection objeto e retorna um ponteiro para ele.