CInternetSession::OpenURL

Artigo
08/25/2010

Chame esse membro funçã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 junto com a solicitação.

CStdioFile* OpenURL(
    LPCTSTR pstrURL,
   DWORD_PTR dwContext = 1,
   DWORD dwFlags = INTERNET_FLAG_TRANSFER_ASCII,
   LPCTSTR pstrHeaders = NULL,
   DWORD dwHeadersLength = 0 
);

Parâmetros

pstrURL
Um ponteiro para o nome do URL para começar a leitura.Apenas URLs a partir do arquivo:, ftp:, gopher:, ou http: são suportados.DECLARAÇÕES if pszURL is NULO.
dwContext
Um valor definido pelo aplicativo passado com o identificador retornado em retorno de chamada.
dwFlags
Os sinalizadores que descrevem como manipular esta conexão.See Comentários para obter mais informações sobre os sinalizadores válido.Os sinalizadores válido são:
- INTERNET_FLAG_TRANSFER_ASCII O padrão.transferência o arquivo sistema autônomo texto ASCII.
- INTERNET_FLAG_TRANSFER_BINARY transferência o arquivo sistema autônomo um arquivo binário.
- INTERNET_FLAG_RELOAD Obter os dados da conexão, mesmo que ele localmente é armazenado em cache.
- INTERNET_FLAG_DONT_CACHE Não armazenar em cache os dados, localmente ou em qualquer gateways.
- INTERNET_FLAG_SECURE Este sinalizar é aplicável a somente solicitações HTTP. Ele solicita transações seguras na conexão com Secure Sockets camada ou PCT
- INTERNET_OPEN_FLAG_USE_EXISTING_CONNECT Se possível, reutilizar as conexões existentes para o servidor para novas solicitações geradas por OpenUrl em vez de criar uma nova sessão para cada solicitação de conexão.
- INTERNET_FLAG_PASSIVE Usado para um site FTP.Usa a semântica FTP passiva.Usado com CInternetConnection of OpenURL.
pstrHeaders
Um ponteiro para uma seqüência de caracteres que contém os cabeçalhos sejam enviadas para o servidor HTTP.
dwHeadersLength
O comprimento, em caracteres, dos cabeçalhos adicionais.Se isso for-1 L e pstrHeaders é não-NULO, then pstrHeaders pressupõe-se zero finalizado e o comprimento é calculado.

Valor de retorno

Retorna um identificador de arquivo para serviços FTP, GOPHER, HTTP e tipo de arquivo Internet somente. RetornaNULO se analisar não teve êxito.

O ponteiro que OpenURL Retorna depende pszURL do tipo de serviço.A tabela abaixo ilustra o ponteiros possíveis OpenURL pode retornar.

Tipo de URL	Retornos
arquivo: / /	CStdioFile *
http://	CHttpFile *
gopher://	CGopherFile *
FTP: / /	CInternetFile *

Comentários

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

OpenURL, que encapsula a função do Win32 InternetOpenURL, permite que somente download, recuperando e ler os dados de um servidor da Internet.OpenURL permite que nenhuma manipulação de arquivo em um local remoto, isso não requer CInternetConnection objeto.

Para usar específico da conexão (ou seja, específicos de protocolo) funções, sistema autônomo gravar um arquivo, você deve em em aberto uma sessão, abra um determinado tipo de conexão, então usar essa conexão para em em aberto um arquivo no modo desejado.See CInternetConnection Para obter mais informações sobre funções específicas de conexão.