Função HttpSendRequestExW (wininet.h)

Artigo
11/20/2024

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

Observação Chamadores que precisam enviar dados extras além do que normalmente é passado para httpSendRequestEx podem fazer isso chamando HttpSendRequest.

Sintaxe

BOOL HttpSendRequestExW(
  [in]  HINTERNET           hRequest,
  [in]  LPINTERNET_BUFFERSW lpBuffersIn,
  [out] LPINTERNET_BUFFERSW 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 de status tiver sido registrada.

Valor de retorno

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

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

Observações

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 fazê-lo chamando HttpSendRequest. Após a chamada para HttpSendRequestEx, envie os dados restantes chamando InternetWriteFile. Por fim, siga com uma chamada para httpEndRequest.

Observação A função HttpSendRequestExA representa dados a serem enviados como caracteres ISO-8859-1 e não caracteres 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.

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 HttpSendRequestEx 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

sessões HTTP

do WinINet Functions

Compartilhar via