CInternetSession::CInternetSession

Artículo
02/19/2013

Esta función se denomina miembro cuando se crea un objeto de CInternetSession .

CInternetSession(
   LPCTSTR pstrAgent = NULL,
   DWORD_PTR dwContext = 1,
   DWORD dwAccessType = PRE_CONFIG_INTERNET_ACCESS,
   LPCTSTR pstrProxyName = NULL,
   LPCTSTR pstrProxyBypass = NULL,
   DWORD dwFlags = 0 
);

Parámetros

pstrAgent
Un puntero a una cadena que identifica el nombre de la aplicación o la entidad que llama a internet funciona (por ejemplo, “explorador de Microsoft Internet”).Si pstrAgent es NULL (valor predeterminado), el marco de trabajo llama a la función global AfxGetAppName, que devuelve una cadena terminada en null que contiene un nombre de aplicación.Algunos protocolos utilizan esta cadena para identificar la aplicación en el servidor.
dwContext
El identificador del contexto de la operación.dwContext identifica la información de estado de la operación devuelta por CInternetSession:: OnStatusCallback.El valor predeterminado se establece en 1; sin embargo, puede asignar explícitamente un Id. de contexto específico para la operación.El objeto y cualquier trabajo que lo haga se asociado con ese identificador de contexto
dwAccessType
El tipo de acceso necesario.Los siguientes son valores válidos, uno de los cuales pueden suministrar exactamente:
- INTERNET_OPEN_TYPE_PRECONFIG conectarse mediante valores preconfigurados en el registro.Establecen a este tipo de acceso como valor predeterminado.Para conectarse a un servidor proxy de TIS, establezca dwAccessType a este valor; establezca el registro correctamente.
- INTERNET_OPEN_TYPE_DIRECT conectarse directamente a internet.
- INTERNET_OPEN_TYPE_PROXY conectarse con un proxy de CERN.
Para obtener información sobre cómo conectar con distintos tipos de proxy, vea Pasos en una aplicación de cliente FTP de Típica.
pstrProxyName
El nombre del proxy preferido de CERN si dwAccessType se establece como INTERNET_OPEN_TYPE_PROXY.El valor predeterminado es NULL.
pstrProxyBypass
Un puntero a una cadena que contiene una lista opcional de direcciones del servidor.Estas direcciones pueden omitirse al utilizar el acceso de proxy.Si se proporciona un valor NULL, la lista de omisión se lea del registro.Este parámetro es significativo únicamente si dwAccessType se establece en INTERNET_OPEN_TYPE_PROXY.
dwFlags
Indica las diferentes opciones de almacenamiento en caché.El valor predeterminado se establece en 0.Inclusión de valores posibles:
- INTERNET_FLAG_DONT_CACHE no almacena en caché los datos, ya sea localmente o en los servidores de puerta de enlace.
- Las operaciones de descarga deINTERNET_FLAG_OFFLINE se cumplen a través de caché persistente únicamente.Si el elemento no existe en caché, se devuelve un código de error adecuado.Este marcador se puede combinar con OR bit a bit (|) operador.

Comentarios

CInternetSession es la primera función de internet llama una aplicación.Inicializa las estructuras de datos internas y se prepara para las llamadas posteriores de la aplicación.

Si ninguna conexión a Internet puede abrirse, CInternetSession produce AfxThrowInternetException.