CInternetSession::CInternetSession

CInternetSession (LPCTSTR pstrAgent = NULL, DWORD dwContext = 1, DWORD dwAccessType = INTERNET_OPEN_TYPE_PRECONFIG, 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 llamada a las funciones de Internet (por ejemplo, "Microsoft Internet Browser"). Si pstrAgent es NULL (valor predeterminado), el marco llama a la función global AfxGetAppName, que devuelve una cadena terminada en nulo conteniendo el nombre de una aplicación. Algunos protocolos usan esta cadena para identificar la aplicación en el servidor.

dwContext

El identificador de 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 no estará asociados con ese ID de contexto. Si dwFlags incluye INTERNET_FLAG_ASYNC, objetos creados por este objeto tengan un comportamiento asincrónico como una rutina de devolución de llamada de Estado está registrada. Para que una función para completarse de forma sincrónica, se ha establecido en cero para esa llamada dwContext.

dwAccessType

El tipo de acceso requerido. Los siguientes son valores válidos, exactamente uno de los cuales puede ser proporcionado:

pstrProxyName

El nombre del proxy CERN preferido 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 se pueden omite cuando se utiliza acceso proxy. Si se suministra un valor NULL , la lista de omisión se leerán desde el registro. Este parámetro sólo tiene sentido si dwAccessType se establece en INTERNET_OPEN_TYPE_PROXY.

dwFlags

Indica varias opciones tales como comportamiento de almacenamiento en caché y asincrónico. El valor predeterminado se establece en 0. Los valores posibles se incluyen:

Observaciones

Esta función miembro es llamada cuando se crea un objeto CInternetSession . CInternetSession es la primera función de Internet llamada por una aplicación. Se inicializa las estructuras de datos internas y se prepara para futuras llamadas desde la aplicación.

Si dwFlags incluye INTERNET_FLAG_ASYNC, entonces todos los identificadores derivados de este identificador tendrá comportamiento asincrónico como una rutina de devolución de llamada de Estado está registrada.

Si no se puede abrir ninguna conexión a Internet, CInternetSession produce un AfxThrowInternetException.

Introducción a CInternetSession |nbsp; Miembros de clase | Diagrama de jerarquía

Vea tambié&nnbsp;CInternetSession::Close, CInternetSession::EnableStatusCallback, CInternetSession::GetContext

Index