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

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

Синтаксис

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