CInternetSession::OpenURL

Artigo
06/10/2015

Chamar essa função de membro para enviar a solicitação específica para o servidor HTTP e para permitir que o cliente especifica cabeçalhos adicionais de RFC822, MIME, ou HTTP para enviar juntamente 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 iniciar a ler. Somente URL que começam com file:, ftp:, gopher:, ou http: são suportados. ASSERTS se o pszURL é NULO.
dwContext
Um valor definido passados com o identificador retornado no retorno de chamada.
dwFlags
Os sinalizadores que descrevem como manipular a conexão. Consulte Comentários para obter mais informações sobre os sinalizadores válidos. Os sinalizadores são válidas:
- INTERNET_FLAG_TRANSFER_ASCII a opção. Transferir o arquivo como texto ASCII.
- Transferência deINTERNET_FLAG_TRANSFER_BINARY o arquivo como um arquivo binário.
- INTERNET_FLAG_RELOAD obtém os dados do fio mesmo se é armazenado em cache localmente.
- INTERNET_FLAG_DONT_CACHE não armazena em cache os dados localmente, ou em qualquer gateways.
- INTERNET_FLAG_SECURE este sinalizador é aplicável somente às solicitações HTTP. Solicita transações seguros no fio com secure sockets layer ou o PCT.
- INTERNET_OPEN_FLAG_USE_EXISTING_CONNECT se possível, reutilizando 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 usou para um site FTP. Usa a semântica passiva FTP. Usado com CInternetConnection de OpenURL.
pstrHeaders
Um ponteiro para uma cadeia de caracteres que contém os cabeçalhos a ser enviados para o servidor HTTP.
dwHeadersLength
O comprimento, os caracteres, headers adicionais. Se este é -1L e pstrHeaders não éNULO, então pstrHeaders é assumido ser encerrado o comprimento zero e é calculado.

Valor de retorno

Retorna um identificador de arquivo para FTP, GOPHER, HTTP, e serviços de Internet do tipo de arquivo somente. Retorna se NULO analisar foi mal sucedido.

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

Tipo de URL	Retornos
file://	CStdioFile*
http://	CHttpFile*
gopher://	CGopherFile*
ftp://	CInternetFile*

Comentários

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

OpenURL, que envolve a função InternetOpenURLWin32, deixando somente baixar, recuperar, e ler os dados de um servidor da Internet. OpenURL não permite nenhuma manipulação de arquivo em um local remoto, o que não requer nenhum objeto de CInternetConnection .

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