CInternetSession::GetHttpConnection

Chamar essa função de membro para estabelecer uma conexão HTTP e obter um ponteiro para um CHttpConnection objeto.

CHttpConnection* GetHttpConnection(
   LPCTSTR pstrServer,
   INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER,
   LPCTSTR pstrUserName = NULL,
   LPCTSTR pstrPassword = NULL 
);
CHttpConnection* GetHttpConnection(
   LPCTSTR pstrServer,
   DWORD dwFlags,
   INTERNET_PORT nPort = INTERNET_INVALID_PORT_NUMBER,
   LPCTSTR pstrUserName = NULL,
   LPCTSTR pstrPassword = NULL 
);

Parâmetros

  • pstrServer
    Um ponteiro para uma seqüência de caracteres que contém o nome do servidor HTTP.

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

  • pstrUserName
    Um ponteiro para uma seqüência de caracteres que contém o nome de usuário.

  • pstrPassword
    Um ponteiro para uma seqüência de caracteres que contém a senha de acesso.

  • dwFlags
    Qualquer combinação do INTERNET_ FLAG_ * sinalizadores.Consulte a tabela no Comentários seção CHttpConnection::OpenRequest para obter uma descrição de dwFlags valores.

Valor de retorno

Um ponteiro para um CHttpConnection objeto.Se a telefonar falhar, determinar a causa da falha, examinando o geradas CInternetException objeto.

Comentários

GetHttpConnection se conecta a um servidor HTTP e cria e retorna um ponteiro para um CHttpConnection objeto. Ele não executa qualquer operação específica no servidor.Se você tiver a intenção de consultar um cabeçalho HTTP, por exemplo, você deve realizar essa operação uma etapa separada.Consulte as classes CHttpConnection and CHttpFile para obter informações sobre as operações podem ser executadas por meio de uma conexão a um servidor HTTP.Para obter informações sobre navegação a um site HTTP, consulte a função de membro OpenURL.Consulte o artigo Programação de Internet com WinInet para o procedimento de executar tarefas comuns de conexão HTTP.

Exceções

Esse método pode lançar exceções do tipo CInternetException*.

Requisitos

Cabeçalho: afxinet.h

Consulte também

Referência

Classe CInternetSession

Gráfico de hierarquia

Classe CHttpConnection

CInternetSession::GetGopherConnection

CInternetSession::GetFtpConnection

CInternetSession::OpenURL

Outros recursos

CInternetSession membros