CHttpFile::AddRequestHeaders

Artikel
02/26/2013

Rufen Sie die Memberfunktion auf, um eine oder mehrere HTTP-Anforderungsheader dem HTTP-Anforderungs-Handle hinzuzufügen.

BOOL AddRequestHeaders(
   LPCTSTR pstrHeaders,
   DWORD dwFlags = HTTP_ADDREQ_FLAG_ADD_IF_NEW,
   int dwHeadersLen = -1 
);
BOOL AddRequestHeaders(
   CString& str,
   DWORD dwFlags = HTTP_ADDREQ_FLAG_ADD_IF_NEW 
);

Parameter

pstrHeaders
Ein Zeiger auf eine Zeichenfolge, die den Header oder die Header enthält, um die Anforderung zuzuordnen.Jeder Header muss von einem CR/LF-Paar beendet werden.
dwFlags
Ändert die Semantik der neuen Header.Einer der folgenden Werte ist möglich:
- HTTP_ADDREQ_FLAG_COALESCE führt Header desselben Namens, mithilfe des Flags zusammen, um den ersten Header hinzuzufügen, der dem folgenden Header gefunden wird.Beispielsweise "akzeptieren Sie: text/*", die von "folgen, annehmen: audio/*" Ergebnisse in der einzelnen Bildung des Headers "annehmen: text/*, audio/*".Es ist durch die aufrufende Anwendung, um einen zusammenhängenden Schemas in Bezug auf die Daten sicherzustellen, die durch die Anforderungen empfangen werden, die mit verschmolzen oder Headern zu trennen gesendet werden.
- HTTP_ADDREQ_FLAG_REPLACE führt ein entfernte aus und fügt hinzu, um den aktuellen Header zu ersetzen.Der Headername wird verwendet, um den aktuellen Header zu entfernen, und vollständigen Wert wird verwendet, um den neuen Header hinzuzufügen.Wenn der HeaderWert leer ist und der Header gefunden wird, wird es entfernt.Wenn nicht leer ist, wird der HeaderWert ersetzt.
- HTTP_ADDREQ_FLAG_ADD_IF_NEW fügt lediglich den Header hinzu, wenn er nicht bereits vorhanden ist.Wenn vorhanden, wird ein Fehler zurückgegeben.
- HTTP_ADDREQ_FLAG_ADD verwendete mit REPLACE.Fügt den Header hinzu, wenn er nicht vorhanden ist.
dwHeadersLen
Die Länge, in Zeichen, von pstrHeaders.Wenn dieses -1L ist, wird pstrHeaders angenommen, um mit 0 (null) endende sein und die Länge wird berechnet.
str
Ein Verweis auf ein CString-Objekt, das den hinzugefügt werden Anforderungsheader oder die Header enthält.

Rückgabewert

Ungleich 0 (null), wenn erfolgreich; 0 andernfalls.Wenn der Aufruf fehlschlägt, wird die GetLastError Win32-Funktion aufgerufen werden, um die Fehlerursache zu bestimmen.

Hinweise

AddRequestHeaders fügt zusätzliche, FREEFormat Header zum HTTP-Anforderungs-Handle an.Es wird für komplexe Client vorgesehen, die auf Kontrolle über die genauen Anforderung benötigen, die dem HTTP-Server gesendet wird.

Hinweis
Die Anwendung kann mehrere Header in pstrHeaders oder in str für einen AddRequestHeaders Aufruf mit HTTP_ADDREQ_FLAG_ADD oder HTTP_ADDREQ_FLAG_ADD_IF_NEW übergeben.Wenn die Anwendung versucht, einen Header mit HTTP_ADDREQ_FLAG_REMOVE oder HTTP_ADDREQ_FLAG_REPLACE zu entfernen oder zu ersetzen, nur ein Header in lpszHeaders angegeben werden kann.