Función InternetQueryDataAvailable (wininet.h)

  • Artículo

Consulta al servidor para determinar la cantidad de datos disponibles.

Sintaxis

BOOL InternetQueryDataAvailable(
  [in]  HINTERNET hFile,
  [out] LPDWORD   lpdwNumberOfBytesAvailable,
  [in]  DWORD     dwFlags,
  [in]  DWORD_PTR dwContext
);

Parámetros

[in] hFile

Identificador devuelto por la función InternetOpenUrl, FtpOpenFile, GopherOpenFile o HttpOpenRequest .

[out] lpdwNumberOfBytesAvailable

Puntero a una variable que recibe el número de bytes disponibles. Puede ser NULL.

[in] dwFlags

Este parámetro está reservado y debe ser 0.

[in] dwContext

Este parámetro está reservado y debe ser 0.

Valor devuelto

Devuelve TRUE si la función se realiza correctamente o FALSE en caso contrario. Para obtener información de error extendida, llame a GetLastError. Si la función no encuentra archivos coincidentes, GetLastError devuelve ERROR_NO_MORE_FILES.

Comentarios

Esta función devuelve el número de bytes de datos que están disponibles para ser leídos inmediatamente mediante una llamada posterior a InternetReadFile. Si actualmente no hay datos disponibles y no se ha alcanzado el final del archivo, la solicitud espera hasta que los datos estén disponibles. La cantidad de datos restantes no se volverá a calcular hasta que se lean todos los datos disponibles indicados por la llamada a InternetQueryDataAvailable .

En el caso de los identificadores HINTERNET creados por HttpOpenRequest y enviados por HttpSendRequestEx, se debe realizar una llamada a HttpEndRequest en el identificador antes de que se pueda usar InternetQueryDataAvailable .

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).
 

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
Library Wininet.lib
Archivo DLL Wininet.dll

Consulte también

Funciones comunes

Funciones de WinINet