Прочитать на английском

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


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

Считывает данные из дескриптора, открываемого функцией 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