Функция InternetQueryDataAvailable (wininet.h)

Статья
03/04/2024

Запрашивает сервер для определения объема доступных данных.

Синтаксис

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

Параметры

[in] hFile

Дескриптор, возвращаемый функцией InternetOpenUrl, FtpOpenFile, GopherOpenFile или HttpOpenRequest .

[out] lpdwNumberOfBytesAvailable

Указатель на переменную, которая получает количество доступных байтов. Может иметь значение NULL.

[in] dwFlags

Этот параметр зарезервирован и должен иметь значение 0.

[in] dwContext

Этот параметр зарезервирован и должен иметь значение 0.

Возвращаемое значение

Возвращает значение TRUE , если функция выполнена успешно, или false в противном случае. Дополнительные сведения об ошибке можно получить, вызвав GetLastError. Если функция не находит соответствующие файлы, GetLastError возвращает ERROR_NO_MORE_FILES.

Эта функция возвращает количество байтов данных, доступных для немедленного чтения при последующем вызове InternetReadFile. Если в настоящее время нет доступных данных и конец файла не достигнут, запрос ожидает, пока данные не станут доступными. Объем оставшихся данных не будет пересчитан, пока не будут считаны все доступные данные, указанные в вызове InternetQueryDataAvailable .

Для дескрипторов HINTERNET, созданных httpOpenRequest и отправленных httpSendRequestEx, перед использованием InternetQueryDataAvailable необходимо выполнить вызов HttpEndRequest.

Как и все другие аспекты API WinINet, эту функцию нельзя безопасно вызывать из библиотеки DllMain или из конструкторов и деструкторов глобальных объектов.

Примечание WinINet не поддерживает реализации сервера. Кроме того, его не следует использовать из службы. Для серверных реализаций или служб используйте службы Microsoft Windows HTTP (WinHTTP).

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	wininet.h
Библиотека	Wininet.lib
DLL	Wininet.dll

См. также раздел

Общие функции

Функции WinINet

Поделиться через