INTERNET_STATUS_CALLBACK función de devolución de llamada (wininet.h)
Prototipo de una función de devolución de llamada de estado definida por la aplicación.
El tipo INTERNET_STATUS_CALLBACK define un puntero a esta función de devolución de llamada. InternetStatusCallback es un marcador de posición para el nombre de función definido por la aplicación.
Sintaxis
INTERNET_STATUS_CALLBACK InternetStatusCallback;
void InternetStatusCallback(
[in] HINTERNET hInternet,
[in] DWORD_PTR dwContext,
[in] DWORD dwInternetStatus,
[in] LPVOID lpvStatusInformation,
[in] DWORD dwStatusInformationLength
)
{...}
Parámetros
[in] hInternet
Identificador para el que se llama a la función de devolución de llamada.
[in] dwContext
Puntero a una variable que especifica el valor de contexto definido por la aplicación asociado a hInternet.
[in] dwInternetStatus
Código de estado que indica por qué se llama a la función de devolución de llamada. Este parámetro puede ser uno de los valores siguientes.
| Valor | Significado |
|---|---|
|
Cerrando la conexión al servidor. El parámetro lpvStatusInformation es NULL. |
|
Se ha conectado correctamente a la dirección de socket (SOCKADDR) a la que apunta lpvStatusInformation. |
|
Conexión a la dirección del socket (SOCKADDR) a la que apunta lpvStatusInformation. |
|
Se ha cerrado correctamente la conexión al servidor. El parámetro lpvStatusInformation es NULL. |
|
Recuperar contenido de la memoria caché. Contiene datos sobre eventos de cookies anteriores para la dirección URL, como si las cookies se aceptaran, rechazaran, degradaron o se aplicaron una correa.
El parámetro lpvStatusInformation es un puntero a una estructura InternetCookieHistory . |
|
Indica el número de cookies aceptadas, rechazadas, degradadas (cambiadas de cookies persistentes a de sesión) o de correas (solo se enviarán en el contexto de la primera parte). El parámetro lpvStatusInformation es un DWORD con el número de cookies recibidas. |
|
Indica el número de cookies enviadas o suprimidas, cuando se envía una solicitud. El parámetro lpvStatusInformation es un DWORD con el número de cookies enviadas o suprimidas. |
|
Sin implementar. |
|
Notifica a la aplicación cliente que se ha detectado un proxy. |
|
Este valor de identificador se ha terminado. pvStatusInformation contiene la dirección del identificador que se está cerrando. El parámetro lpvStatusInformation contiene la dirección del identificador que se está cerrando. |
|
Lo usa InternetConnect para indicar que ha creado el nuevo identificador. Esto permite que la aplicación llame a InternetCloseHandle desde otro subproceso, si la conexión tarda demasiado tiempo. El parámetro lpvStatusInformation contiene la dirección de un identificador HINTERNET . |
|
Recibió un mensaje de código de estado intermedio (100 niveles) del servidor. |
|
Encontró correctamente la dirección IP del nombre incluido en lpvStatusInformation. El parámetro lpvStatusInformation apunta a un PCTSTR que contiene el nombre de host. |
|
La respuesta tiene un encabezado P3P en ella. |
|
Sin implementar. |
|
Sin implementar. |
|
Sin implementar. |
|
Esperando que el servidor responda a una solicitud. El parámetro lpvStatusInformation es NULL. |
|
Una solicitud HTTP está a punto de redirigir automáticamente la solicitud. El parámetro lpvStatusInformation apunta a la nueva dirección URL. En este momento, la aplicación puede leer los datos devueltos por el servidor con la respuesta de redireccionamiento y puede consultar los encabezados de respuesta. También puede cancelar la operación cerrando el identificador. Esta devolución de llamada no se realiza si la solicitud original especificada INTERNET_FLAG_NO_AUTO_REDIRECT. |
|
Se ha completado una operación asincrónica. El parámetro lpvStatusInformation contiene la dirección de una estructura de INTERNET_ASYNC_RESULT . |
|
Se ha enviado correctamente la solicitud de información al servidor. El parámetro lpvStatusInformation apunta a un valor DWORD que contiene el número de bytes enviados. |
|
Buscar la dirección IP del nombre incluido en lpvStatusInformation. El parámetro lpvStatusInformation apunta a un PCTSTR que contiene el nombre de host. |
|
Se recibió correctamente una respuesta del servidor. |
|
Enviando la solicitud de información al servidor. El parámetro lpvStatusInformation es NULL. |
|
Se ha movido entre un sitio seguro (HTTPS) y un sitio no seguro (HTTP). Se debe informar al usuario de este cambio; de lo contrario, el usuario corre el riesgo de revelar información confidencial de forma involuntaria. Cuando se establece esta marca, el parámetro lpvStatusInformation apunta a un estado DWORD que contiene marcas adicionales. |
[in] lpvStatusInformation
Puntero a información de estado adicional. Cuando se establece la marca INTERNET_STATUS_STATE_CHANGE , lpvStatusInformation apunta a un DWORD que contiene una o varias de las marcas siguientes:
[in] dwStatusInformationLength
Tamaño, en bytes, de los datos a los que apunta lpvStatusInformation.
Valor devuelto
None
Observaciones
Dado que las devoluciones de llamada se realizan durante el procesamiento de la solicitud, la aplicación debe dedicar poco tiempo a la función de devolución de llamada para evitar degradar el rendimiento de los datos en la red. Por ejemplo, mostrar un cuadro de diálogo en una función de devolución de llamada puede ser una operación tan larga que el servidor finaliza la solicitud.
Se puede llamar a la función de devolución de llamada en un contexto de subproceso diferente del subproceso que inició la solicitud.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 2000 Professional [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows 2000 Server [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | wininet.h |