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

Статья
11/20/2024

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

Синтаксис

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

Параметры

[in] hFile

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

[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 Services (WinHTTP).

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	wininet.h
библиотеки	Wininet.lib
DLL	Wininet.dll

См. также

common Functions

функций WinINet

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