Función InternetSetStatusCallbackA (wininet.h)

La función InternetSetStatusCallback configura una función de devolución de llamada a la que las funciones winINet pueden llamar a medida que se realiza el progreso durante una operación.

Sintaxis

INTERNET_STATUS_CALLBACK InternetSetStatusCallbackA(
  HINTERNET                hInternet,
  INTERNET_STATUS_CALLBACK lpfnInternetCallback
);

Parámetros

hInternet

Identificador para el que se establece la devolución de llamada.

lpfnInternetCallback

Puntero a la función de devolución de llamada para llamar cuando se realiza el progreso o NULL para quitar la función de devolución de llamada existente. Para obtener más información sobre la función de devolución de llamada, consulte InternetStatusCallback.

Valor devuelto

Devuelve la función de devolución de llamada de estado definida anteriormente si se ejecuta correctamente, NULL si no había ninguna función de devolución de llamada de estado definida previamente o INTERNET_INVALID_STATUS_CALLBACK si la función de devolución de llamada no es válida.

Observaciones

Las funciones sincrónicas y asincrónicas usan la función de devolución de llamada para indicar el progreso de la solicitud, como resolver un nombre, conectarse a un servidor, etc. La función de devolución de llamada es necesaria para una operación asincrónica. La solicitud asincrónica volverá a llamar a la aplicación con INTERNET_STATUS_REQUEST_COMPLETE para indicar que se ha completado la solicitud.

Una función de devolución de llamada se puede establecer en cualquier identificador y se hereda por identificadores derivados. Se puede cambiar una función de devolución de llamada mediante InternetSetStatusCallback, siempre que no haya solicitudes pendientes que necesiten usar el valor de devolución de llamada anterior. Tenga en cuenta, sin embargo, que cambiar la función de devolución de llamada en un identificador no cambia las devoluciones de llamada en identificadores derivados, como el devuelto por InternetConnect. Debe cambiar la función de devolución de llamada en cada nivel.

Muchas de las funciones de WinINet realizan varias operaciones en la red. Cada operación puede tardar tiempo en completarse y cada una puede producir un error.

A veces es conveniente mostrar información de estado durante una operación a largo plazo. Puede mostrar información de estado configurando una función de devolución de llamada de estado de Internet que no se puede quitar siempre y cuando haya devoluciones de llamada o funciones asincrónicas pendientes.

Después de iniciar InternetSetStatusCallback, se puede acceder a la función de devolución de llamada desde cualquier función winINet para supervisar las operaciones de red que consumen mucho tiempo.

Nota La función de devolución de llamada especificada en el parámetro lpfnInternetCallback no se llamará en operaciones asincrónicas para el identificador de solicitud cuando el parámetro dwContext de dwContext de El HttpOpenRequest se establece en cero (INTERNET_NO_CALLBACK) o el identificador de conexión cuando el identificador de dwContext de InternetConnect está establecido en cero (INTERNET_NO_CALLBACK).

Al igual que todos los demás aspectos de la API de WinINet, esta función no se puede llamar de forma segura desde DllMain ni desde los constructores y destructores de objetos globales.

Nota WinINet no admite implementaciones de servidor. Además, no se debe usar desde un servicio. En el caso de las implementaciones de servidor o los servicios, use Servicios HTTP de Microsoft Windows (WinHTTP).

 

Nota

El encabezado wininet.h define InternetSetStatusCallback como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
encabezado de	wininet.h

Consulte también

funciones comunes

internetStatusCallback

funciones winINet