Função InternetReadFileExA (wininet.h)

Artigo
11/20/2024

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 ser um dos valores a seguir.

Valor	Significado
IRF_ASYNC	Idêntico ao 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 aguarde os 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 chamador forneceu o valor de contexto usado para operações assíncronas.

Valor de retorno

Retorna 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.

Observações

Observaçã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 ou serviços de servidor, use do Microsoft Windows HTTP Services (WinHTTP).

Nota

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 do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 2000 Professional [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows 2000 Server [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	wininet.h
biblioteca	Wininet.lib
de DLL	Wininet.dll

Consulte também

funções comuns

do WinINet Functions

Compartilhar via