CInternetSession::OpenURL

Artículo
02/19/2013

Llame a esta función miembro para enviar la solicitud especificada al servidor HTTP y permitir que el cliente especifique RF adicional C822, MIME, o encabezados HTTP para enviar junto con la solicitud.

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

Parámetros

pstrURL
Un puntero al nombre de la dirección URL a iniciar lectura.Sólo direcciones URL a partir de file:, ftp:, gopher:, o HTTP: se admiten.ASSERTS si el pszURL es NULL.
dwContext
Un valor definido por la aplicación pasado con el identificador devuelto en la devolución.
dwFlags
Marcas que describen cómo controlar esta conexión.Vea Comentarios para obtener más información sobre las marcas válidas.los indicadores válidos son:
- Valor predeterminado deINTERNET_FLAG_TRANSFER_ASCII The.Transferir el archivo como texto ASCII.
- Transferencia deINTERNET_FLAG_TRANSFER_BINARY el archivo como un archivo binario.
- INTERNET_FLAG_RELOAD recibe los datos de conexión aunque localmente se almacena en memoria caché.
- INTERNET_FLAG_DONT_CACHE no almacena en caché los datos, ya sea localmente o en ninguna puertas de enlace.
- El indicador deINTERNET_FLAG_SECURE Esta es aplicable a las solicitudes HTTP solo.Solicita transacciones seguras en la conexión con la capa de sockets seguros o el PCT.
- INTERNET_OPEN_FLAG_USE_EXISTING_CONNECT si es posible, reutiliza las conexiones existentes en el servidor para las nuevas solicitudes generadas por OpenUrl en lugar de crear una nueva sesión para cada solicitud de conexión.
- INTERNET_FLAG_PASSIVE utilizado para un sitio FTP.Usa la semántica pasiva FTP.Se utiliza con CInternetConnection de OpenURL.
pstrHeaders
Un puntero a una cadena que contiene los encabezados que se envían al servidor HTTP.
dwHeadersLength
Longitud, en caracteres, de los encabezados adicionales.Si es -1L y pstrHeaders no es null, después pstrHeaders se asume que cero finalizado y se calcula la longitud.

Valor devuelto

Devuelve un identificador de archivos para FTP, GOPHER, el HTTP, y los servicios Internet de Archivo-tipo únicamente.Devuelve NULL si el análisis se intentó.

El puntero que OpenURL devuelve depende del tipo de los pszURL.La tabla siguiente muestra los punteros posibles que OpenURL puede devolver.

Tipo URL	Valores devueltos
file://	CStdioFile*
http://	CHttpFile*
gopher://	CGopherFile*
ftp://	CInternetFile*

Comentarios

el parámetro dwFlags debe incluir INTERNET_FLAG_TRANSFER_ASCII o INTERNET_FLAG_TRANSFER_BINARY, pero no ambos.Marcas restantes se pueden combinar con el operador bit a bit de OR (|).

OpenURL, que encapsula la función InternetOpenURLde Win32, solamente permite la descarga, el recuperar, y la lectura de los datos de un servidor de Internet.OpenURL no permite ninguna manipulación de archivos en una ubicación remota, por lo que no requiere ningún objeto de CInternetConnection .

Para utilizar (es decir,) funciones protocolo-específicas específicas de la conexión, como escribir en un archivo, debe iniciar sesión, abra una clase determinada de conexión, después de uso esa conexión de abrir un archivo en modo deseado.Vea CInternetConnection para obtener más información sobre las funciones específicas de la conexión.