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

  • Статья

Считывает данные из дескриптора, открытого функцией InternetOpenUrl или HttpOpenRequest .

Синтаксис

BOOL InternetReadFileExA(
  [in]  HINTERNET           hFile,
  [out] LPINTERNET_BUFFERSA lpBuffersOut,
  [in]  DWORD               dwFlags,
  [in]  DWORD_PTR           dwContext
);

Параметры

[in] hFile

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

[out] lpBuffersOut

Указатель на структуру INTERNET_BUFFERS , которая получает скачанные данные.

[in] dwFlags

Этот параметр может принимать одно из указанных ниже значений.

Значение Значение
IRF_ASYNC
 Идентично WININET_API_FLAG_ASYNC.
IRF_SYNC
 Идентично WININET_API_FLAG_SYNC.
IRF_USE_CONTEXT
 Идентично WININET_API_FLAG_USE_CONTEXT.
IRF_NO_WAIT
 Не ждите данных. При наличии доступных данных функция возвращает либо запрошенный объем данных, либо объем доступных данных (в зависимости от того, что меньше).

[in] dwContext

Значение контекста, предоставленное вызывающим объектом, используемое для асинхронных операций.

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

Возвращает значение TRUE в случае успешного выполнения или FALSE в противном случае. Дополнительные сведения об ошибке можно получить, вызвав GetLastError. Приложение также может использовать InternetGetLastResponseInfo при необходимости.

Комментарии

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

Примечание

Заголовок wininet.h определяет InternetReadFileEx как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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

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

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

Функции WinINet