Função InternetReadFileExA (wininet.h)

  • Artigo

Lê dados de um identificador aberto pela função InternetOpenUrl ou HttpOpenRequest .

Sintaxe

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

Parâmetros

[in] hFile

Identificador retornado pela função InternetOpenUrl ou HttpOpenRequest .

[out] lpBuffersOut

Ponteiro para uma estrutura INTERNET_BUFFERS que recebe os dados baixados.

[in] dwFlags

Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
IRF_ASYNC
 Idêntico a WININET_API_FLAG_ASYNC.
IRF_SYNC
 Idêntico a WININET_API_FLAG_SYNC.
IRF_USE_CONTEXT
 Idêntico a WININET_API_FLAG_USE_CONTEXT.
IRF_NO_WAIT
 Não espere por dados. Se houver dados disponíveis, a função retornará a quantidade de dados solicitados ou a quantidade de dados disponíveis (o que for menor).

[in] dwContext

Um valor de contexto fornecido pelo chamador usado para operações assíncronas.

Retornar valor

Retornará TRUE se tiver êxito ou FALSE caso contrário. Para obter informações de erro estendidas, chame GetLastError. Um aplicativo também pode usar InternetGetLastResponseInfo quando necessário.

Comentários

Nota O WinINet não dá suporte a implementações de servidor. Além disso, ele não deve ser usado de um serviço. Para implementações de servidor ou serviços, use Os Serviços HTTP do Microsoft Windows (WinHTTP).
 

Observação

O cabeçalho wininet.h define InternetReadFileEx como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho wininet.h
Biblioteca Wininet.lib
DLL Wininet.dll

Confira também

Funções comuns

Funções WinINet