Compartilhar via

Função WinHttpAddRequestHeadersEx (winhttp.h)

  • Artigo

Adiciona um ou mais cabeçalhos de solicitação HTTP a um identificador de solicitação HTTP, permitindo que você use cadeias de caracteres de nome/valor separadas.

Sintaxe

WINHTTPAPI DWORD WinHttpAddRequestHeadersEx(
  HINTERNET               hRequest,
  DWORD                   dwModifiers,
  ULONGLONG               ullFlags,
  ULONGLONG               ullExtra,
  DWORD                   cHeaders,
  WINHTTP_EXTENDED_HEADER *pHeaders
);

Parâmetros

hRequest

Tipo: IN HINTERNET

Um identificador HINTERNET retornado por uma chamada para WinHttpOpenRequest.

dwModifiers

Tipo: IN DWORD

Um valor inteiro longo sem sinal que contém os sinalizadores usados para modificar a semântica dessa função. Pode ser um ou mais dos sinalizadores a seguir.

Valor Significado
WINHTTP_ADDREQ_FLAG_ADD
 Adiciona o cabeçalho se ele não existir. Usado com WINHTTP_ADDREQ_FLAG_REPLACE.
WINHTTP_ADDREQ_FLAG_ADD_IF_NEW
 Adiciona o cabeçalho somente se ele ainda não existir; caso contrário, um erro será retornado.
WINHTTP_ADDREQ_FLAG_COALESCE
 Mescla cabeçalhos de mesmo nome.
WINHTTP_ADDREQ_FLAG_COALESCE_WITH_COMMA
 Mescla cabeçalhos de mesmo nome usando uma vírgula. Por exemplo, adicionar "Aceitar: texto/*" seguido por "Aceitar: áudio/*" com esse sinalizador resulta em um único cabeçalho "Aceitar: texto/*, áudio/*". Isso faz com que o primeiro cabeçalho encontrado seja mesclado. O aplicativo de chamada deve garantir um esquema coeso em relação a cabeçalhos mesclados e separados.
WINHTTP_ADDREQ_FLAG_COALESCE_WITH_SEMICOLON
 Mescla cabeçalhos de mesmo nome usando ponto e vírgula.
WINHTTP_ADDREQ_FLAG_REPLACE
 Substitui ou remove um cabeçalho. Se o valor do cabeçalho estiver vazio e o cabeçalho for encontrado, ele será removido. Se o valor não estiver vazio, ele será substituído.

ullFlags

Tipo: IN ULONGLONG

Passe WINHTTP_EXTENDED_HEADER_FLAG_UNICODE para indicar que as cadeias de caracteres passadas são cadeias de caracteres Unicode.

ullExtra

Tipo: IN ULONGLONG

Reservado.

cHeaders

Tipo: IN DWORD

O número de elementos em pHeaders.

pHeaders

Tipo: _In_reads_(cHeaders) WINHTTP_EXTENDED_HEADER*

Uma matriz de estruturas WINHTTP_EXTENDED_HEADER .

Retornar valor

Um código status que indica o resultado da operação. Entre os códigos de erro retornados estão os seguintes.

Código do Erro Descrição
ERROR_WINHTTP_INCORRECT_HANDLE_STATE
 A operação solicitada não pode ser executada porque o identificador fornecido não está no estado correto.
ERROR_WINHTTP_INCORRECT_HANDLE_TYPE
 O tipo de identificador fornecido está incorreto para esta operação.
ERROR_WINHTTP_INTERNAL_ERROR
 Ocorreu um erro interno.
ERROR_NOT_ENOUGH_MEMORY
 Não havia memória suficiente disponível para concluir a operação solicitada.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10 Build 20348
Servidor mínimo com suporte Windows 10 Build 20348
Plataforma de Destino Windows
Cabeçalho winhttp.h
Biblioteca Winhttp.lib
DLL Winhttp.dll

Confira também