Função HttpSendRequestExA (wininet.h)

  • Artigo

Envia a solicitação especificada para o servidor HTTP.

Nota Os chamadores que precisam enviar dados extras além do que normalmente é passado para HttpSendRequestEx podem fazer isso chamando HttpSendRequest .
 

Sintaxe

BOOL HttpSendRequestExA(
  [in]  HINTERNET           hRequest,
  [in]  LPINTERNET_BUFFERSA lpBuffersIn,
  [out] LPINTERNET_BUFFERSA lpBuffersOut,
  [in]  DWORD               dwFlags,
  [in]  DWORD_PTR           dwContext
);

Parâmetros

[in] hRequest

Um identificador retornado por uma chamada para a função HttpOpenRequest .

[in] lpBuffersIn

Opcional. Um ponteiro para uma estrutura INTERNET_BUFFERS .

[out] lpBuffersOut

Reservado. Deve ser NULL.

[in] dwFlags

Reservado. Deve ser zero.

[in] dwContext

Valor de contexto definido pelo aplicativo, se uma função de retorno de chamada status tiver sido registrada.

Retornar valor

Se a função for bem-sucedida, a função retornará TRUE.

Se a função falhar, ela retornará FALSE. Para obter informações de erro estendidas, chame GetLastError.

Comentários

HttpSendRequestEx executa o envio e o recebimento da resposta. Isso não permite que o aplicativo envie dados extras além do único buffer que foi passado para HttpSendRequestEx. Os chamadores que precisam enviar dados extras além do que normalmente é passado para HttpSendRequestEx podem fazer isso chamando HttpSendRequest . Após a chamada para HttpSendRequestEx, envie os dados restantes chamando InternetWriteFile. Por fim, siga com uma chamada para HttpEndRequest.

Nota A função HttpSendRequestExA representa dados a serem enviados como caracteres ISO-8859-1 e não ANSI. A função HttpSendRequestExW representa dados a serem enviados como caracteres ISO-8859-1 convertidos em caracteres UTF-16LE. Como resultado, nunca é seguro usar a função HttpSendRequestExW quando os cabeçalhos a serem adicionados podem conter caracteres não ASCII. Em vez disso, um aplicativo pode usar as funções MultiByteToWideChar e WideCharToMultiByte com um parâmetro Codepage definido como 28591 para mapear entre caracteres ANSI e caracteres UTF-16LE.
 
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 ou serviços de servidor, use Os Serviços HTTP do Microsoft Windows (WinHTTP).
 

Observação

O cabeçalho wininet.h define HttpSendRequestEx 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

Sessões HTTP

Funções WinINet