Condividi tramite

Funzione WinHttpAddRequestHeadersEx (winhttp.h)

  • Articolo

Aggiunge una o più intestazioni di richiesta HTTP a un handle di richiesta HTTP, consentendo di usare stringhe nome/valore separate.

Sintassi

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

Parametri

hRequest

Tipo: IN SUBNETNET

Handle DI RETE GESTITO restituito da una chiamata a WinHttpOpenRequest.

dwModifiers

Tipo: IN DWORD

Valore intero long senza segno che contiene i flag utilizzati per modificare la semantica di questa funzione. Può essere uno o più dei flag seguenti.

Valore Significato
WINHTTP_ADDREQ_FLAG_ADD
 Aggiunge l'intestazione se non esiste. Usato con WINHTTP_ADDREQ_FLAG_REPLACE.
WINHTTP_ADDREQ_FLAG_ADD_IF_NEW
 Aggiunge l'intestazione solo se non esiste già; in caso contrario, viene restituito un errore.
WINHTTP_ADDREQ_FLAG_COALESCE
 Unisce le intestazioni con lo stesso nome.
WINHTTP_ADDREQ_FLAG_COALESCE_WITH_COMMA
 Unisce le intestazioni dello stesso nome usando una virgola. Ad esempio, aggiungendo "Accept: text/*" seguito da "Accept: audio/*" con questo flag viene restituita una singola intestazione "Accept: text/*, audio/*". In questo modo viene eseguita l'unione della prima intestazione. L'applicazione chiamante deve garantire uno schema coesivo rispetto alle intestazioni unite e separate.
WINHTTP_ADDREQ_FLAG_COALESCE_WITH_SEMICOLON
 Unisce le intestazioni con lo stesso nome usando un punto e virgola.
WINHTTP_ADDREQ_FLAG_REPLACE
 Sostituisce o rimuove un'intestazione. Se il valore dell'intestazione è vuoto e l'intestazione viene trovata, viene rimossa. Se il valore non è vuoto, viene sostituito.

ullFlags

Tipo: IN ULONGLONG

Passare WINHTTP_EXTENDED_HEADER_FLAG_UNICODE per indicare che le stringhe passate sono stringhe Unicode.

ullExtra

Tipo: IN ULONGLONG

Riservato.

cHeaders

Tipo: IN DWORD

Numero di elementi in pHeaders.

pHeaders

Tipo: _In_reads_(cHeaders) WINHTTP_EXTENDED_HEADER*

Matrice di strutture WINHTTP_EXTENDED_HEADER .

Valore restituito

Codice di stato che indica il risultato dell'operazione. Tra i codici di errore restituiti sono riportati di seguito.

Codice di errore Descrizione
ERROR_WINHTTP_INCORRECT_HANDLE_STATE
 Impossibile eseguire l'operazione richiesta perché l'handle fornito non è nello stato corretto.
ERROR_WINHTTP_INCORRECT_HANDLE_TYPE
 Il tipo di handle fornito non è corretto per questa operazione.
ERROR_WINHTTP_INTERNAL_ERROR
 Si è verificato un errore interno.
ERROR_NOT_ENOUGH_MEMORY
 Memoria insufficiente per completare l'operazione richiesta.

Requisiti

Requisito Valore
Client minimo supportato Windows 10 Build 20348
Server minimo supportato Windows 10 Build 20348
Piattaforma di destinazione Windows
Intestazione winhttp.h
Libreria Winhttp.lib
DLL Winhttp.dll

Vedi anche