Compartir a través de

Función WinHttpAddRequestHeadersEx (winhttp.h)

  • Artículo

Agrega uno o varios encabezados de solicitud HTTP a un identificador de solicitud HTTP, lo que le permite usar cadenas de nombre y valor independientes.

Sintaxis

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

Parámetros

hRequest

Tipo: IN HINTERNET

Identificador HINTERNET devuelto por una llamada a WinHttpOpenRequest.

dwModifiers

Tipo: EN DWORD

Valor entero largo sin signo que contiene las marcas usadas para modificar la semántica de esta función. Puede ser una o varias de las marcas siguientes.

Valor Significado
WINHTTP_ADDREQ_FLAG_ADD
 Agrega el encabezado si no existe. Se usa con WINHTTP_ADDREQ_FLAG_REPLACE.
WINHTTP_ADDREQ_FLAG_ADD_IF_NEW
 Agrega el encabezado solo si aún no existe; de lo contrario, se devuelve un error.
WINHTTP_ADDREQ_FLAG_COALESCE
 Combina encabezados con el mismo nombre.
WINHTTP_ADDREQ_FLAG_COALESCE_WITH_COMMA
 Combina encabezados del mismo nombre con una coma. Por ejemplo, agregar "Accept: text/*" seguido de "Accept: audio/*" con esta marca da como resultado un solo encabezado "Accept: text/*, audio/*". Esto hace que se combine el primer encabezado. La aplicación que llama debe garantizar un esquema cohesivo con respecto a encabezados combinados y independientes.
WINHTTP_ADDREQ_FLAG_COALESCE_WITH_SEMICOLON
 Combina encabezados del mismo nombre con un punto y coma.
WINHTTP_ADDREQ_FLAG_REPLACE
 Reemplaza o quita un encabezado. Si el valor del encabezado está vacío y se encuentra el encabezado, se quita. Si el valor no está vacío, se reemplaza.

ullFlags

Tipo: IN ULONGLONG

Pase WINHTTP_EXTENDED_HEADER_FLAG_UNICODE para indicar que las cadenas pasadas son cadenas Unicode.

ullExtra

Tipo: IN ULONGLONG

Reservado.

cHeaders

Tipo: EN DWORD

Número de elementos de pHeaders.

pHeaders

Tipo: WINHTTP_EXTENDED_HEADER _In_reads_(cHeaders)*

Matriz de estructuras de WINHTTP_EXTENDED_HEADER .

Valor devuelto

Código de estado que indica el resultado de la operación. Entre los códigos de error devueltos se encuentran los siguientes.

Código de error Descripción
ERROR_WINHTTP_INCORRECT_HANDLE_STATE
 No se puede realizar la operación solicitada porque el identificador proporcionado no está en el estado correcto.
ERROR_WINHTTP_INCORRECT_HANDLE_TYPE
 El tipo de identificador proporcionado es incorrecto para esta operación.
ERROR_WINHTTP_INTERNAL_ERROR
 Se ha producido un error interno.
ERROR_NOT_ENOUGH_MEMORY
 No había suficiente memoria disponible para completar la operación solicitada.

Requisitos

Requisito Value
Cliente mínimo compatible compilación 20348 de Windows 10
Servidor mínimo compatible compilación 20348 de Windows 10
Plataforma de destino Windows
Encabezado winhttp.h
Library Winhttp.lib
Archivo DLL Winhttp.dll

Consulte también