Freigeben über

WinHttpAddRequestHeadersEx-Funktion (winhttp.h)

  • Artikel

Fügt einem HTTP-Anforderungshandle einen oder mehrere HTTP-Anforderungsheader hinzu, sodass Sie separate Namens-Wert-Zeichenfolgen verwenden können.

Syntax

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

Parameter

hRequest

Typ: IN HINTERNET

Ein HINTERNET-Handle , das von einem Aufruf von WinHttpOpenRequest zurückgegeben wird.

dwModifiers

Typ: IN DWORD

Ein ganzzahliger Wert ohne Vorzeichen, der die Flags enthält, die zum Ändern der Semantik dieser Funktion verwendet werden. Es kann mindestens eins der folgenden Flags sein.

Wert Bedeutung
WINHTTP_ADDREQ_FLAG_ADD
 Fügt den Header hinzu, wenn er nicht vorhanden ist. Wird mit WINHTTP_ADDREQ_FLAG_REPLACE verwendet.
WINHTTP_ADDREQ_FLAG_ADD_IF_NEW
 Fügt den Header nur hinzu, wenn er noch nicht vorhanden ist. andernfalls wird ein Fehler zurückgegeben.
WINHTTP_ADDREQ_FLAG_COALESCE
 Führt Kopfzeilen mit demselben Namen zusammen.
WINHTTP_ADDREQ_FLAG_COALESCE_WITH_COMMA
 Führt Kopfzeilen mit demselben Namen mithilfe eines Kommas zusammen. Das Hinzufügen von "Accept: text/*" gefolgt von "Accept: audio/*" mit diesem Flag führt beispielsweise zu einem einzelnen Header "Accept: text/*, audio/*". Dies führt dazu, dass der erste gefundene Header zusammengeführt wird. Die aufrufende Anwendung muss ein zusammenhängendes Schema in Bezug auf zusammengeführte und separate Header sicherstellen.
WINHTTP_ADDREQ_FLAG_COALESCE_WITH_SEMICOLON
 Führt Kopfzeilen mit demselben Namen mithilfe eines Semikoons zusammen.
WINHTTP_ADDREQ_FLAG_REPLACE
 Ersetzt oder entfernt einen Header. Wenn der Headerwert leer ist und der Header gefunden wird, wird er entfernt. Wenn der Wert nicht leer ist, wird er ersetzt.

ullFlags

Typ: IN ULONGLONG

Übergeben Sie WINHTTP_EXTENDED_HEADER_FLAG_UNICODE , um anzugeben, dass die übergebenen Zeichenfolgen Unicode-Zeichenfolgen sind.

ullExtra

Typ: IN ULONGLONG

Reserviert.

cHeaders

Typ: IN DWORD

Die Anzahl der Elemente in pHeaders.

pHeaders

Typ: _In_reads_(cHeaders) WINHTTP_EXTENDED_HEADER*

Ein Array von WINHTTP_EXTENDED_HEADER Strukturen.

Rückgabewert

Ein status Code, der das Ergebnis des Vorgangs angibt. Zu den zurückgegebenen Fehlercodes gehören die folgenden.

Fehlercode BESCHREIBUNG
ERROR_WINHTTP_INCORRECT_HANDLE_STATE
 Der angeforderte Vorgang kann nicht ausgeführt werden, da sich der angegebene Handle nicht im richtigen Zustand befindet.
ERROR_WINHTTP_INCORRECT_HANDLE_TYPE
 Der Typ des angegebenen Handles ist für diesen Vorgang falsch.
ERROR_WINHTTP_INTERNAL_ERROR
 Ein interner Fehler ist aufgetreten.
ERROR_NOT_ENOUGH_MEMORY
 Für den angeforderten Vorgang war nicht genügend Arbeitsspeicher verfügbar.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10 Build 20348
Unterstützte Mindestversion (Server) Windows 10 Build 20348
Zielplattform Windows
Kopfzeile winhttp.h
Bibliothek Winhttp.lib
DLL Winhttp.dll

Weitere Informationen