CInternetSession:: OpenURL

CStdioFile * OpenURL (LPCTSTR pstrURL, DWORD dwContext = 1, DWORD dwFlags = INTERNET_FLAG_TRANSFER_ASCII, LPCTSTR pstrHeaders = NULL, DWORD dwHeadersLength = 0 );
Lançar (CInternetException);

Valor de retorno

Retorna um identificador de arquivo FTP, GOPHER, HTTP e tipo de arquivo Internet somente para serviços. Retorna NULL se a análise não foi bem sucedido.

O ponteiro que OpenURL retorna depende pszURLdo tipo de serviço. A tabela abaixo ilustra os ponteiros possíveis que OpenURL pode retornar.

Parâmetros

pstrURL

Um ponteiro para o nome do URL para começar a leitura. Apenas URLs a partir do ficheiro:, ftp:, gopher:, ou http: são suportados. ASSERTS se pszURL é Nulo.

dwContext

Um valor definido pelo aplicativo passado com o identificador retornado no retorno de chamada.

dwFlags

Os sinalizadores que descrevem como manipular esta conexão. Consulte comentários para obter mais informações sobre os sinalizadores válidos. Os sinalizadores válidos são:

• I&NTERNET_FLAG_TRANSFER_ASCIInbsp;  O padrão. Transfira o arquivo como texto ASCII.
  
  
• I&NTERNET_FLAG_TRANSFER_BINARYnbsp;  Transfira o arquivo como um arquivo binário.
  
  
• I&NTERNET_FLAG_RELOADnbsp;  Obter os dados de conexão, mesmo se ele é armazenado em cache localmente.
  
  
• I&NTERNET_FLAG_DONT_CACHEnbsp;  Não armazenar em cache os dados, localmente ou em qualquer gateways.
  
  
• I&NTERNET_FLAG_SECUREnbsp;  Este sinalizador é aplicável a somente as solicitações HTTP. Ele solicita transações seguras no fio com SSL ou PCT.
  
  
• I&NTERNET_OPEN_FLAG_USE_EXISTING_CONNECTnbsp;  Se possível, reutilizar as conexões existentes para o servidor para novos solicitações geradas por OpenUrl em vez de criar uma nova sessão para cada solicitação de conexão.
  
  
• I&NTERNET_FLAG_PASSIVEnbsp;  Usado para um site FTP. Usa semântica de FTP passiva. Usado com CInternetConnection de OpenURL.

pstrHeaders

Um ponteiro para uma Cadeia de caracteres que contém os cabeçalhos sejam enviadas para o servidor HTTP.

dwHeadersLength

O comprimento, em caracteres, dos cabeçalhos adicionais. Se esta for L-1 e pstrHeaders é não -NULL, em seguida, pstrHeaders é assumido ser zero finalizado e o comprimento é calculado.

Observações

Chamar esse membro fu&nção para enviar a solicitação especificada para o servidor HTTP e permitir que o cliente especificar RFC822 adicionais, MIME ou cabeçalhos HTTP para enviar juntamente com o request.nbsp;

O parâmetro dwFlags deve incluir INTERNET_FLAG_TRANSFER_ASCII ou INTERNET_FLAG_TRANSFER_BINARY, mas não ambos. Os restantes sinalizadores podem ser combinados com o operador bit a bit ou (|).

OpenURL, que envolve a função de Win32 InternetOpenURL, permite apenas transferindo, recuperando e leitura dos dados de um servidor de Internet. OpenURL não permite nenhuma manipulação de arquivo em um local remoto, portanto, não requer nenhum objeto CInternetConnection.

Para uso específico da conexão (ou seja, protocolo-específicos) funções, como gravar em um arquivo, você deve abrir uma sessão, em seguida, abrir um tipo específico de conexão, em seguida, usar essa conexão para abrir um arquivo no modo desejado. Consulte CInternetConnection para obter mais informações sobre funções específicas de conexão.

Visão geral de CInternetSession |nbsp; Membros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp;CInternetConnection, CGopherConnection, CInternetSession:: GetFtpConnection, CInternetSession:: GetHttpConnection