CHttpFile::AddRequestHeaders
Wywołać funkcję Członkowskie aby dodać jeden lub więcej nagłówków żądania HTTP do żądania HTTP obsłużyć.
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
);
Parametry
pstrHeaders
Wskaźnik ciąg zawierający nagłówka lub nagłówków, aby dołączyć do wniosku.Każdy nagłówek musi być zakończona przez parę CR/LF.dwFlags
Modyfikuje semantykę nowych nagłówków.Może być jedną z następujących czynności:HTTP_ADDREQ_FLAG_COALESCEScala nagłówki o tej samej nazwie, aby dodać nagłówek pierwszej, stwierdzono, że kolejne nagłówka przy użyciu flagi.Na przykład "Akceptuj: tekst / *" następuje "Zaakceptuj: audio / *" powoduje powstanie pojedynczym nagłówku "Akceptuj: tekst / * audio / *".Jest aplikacji wywołującej do zapewnienia spójnego systemu w odniesieniu do danych otrzymanych przez żądania wysyłane z wykonania lub oddzielnych nagłówków.
HTTP_ADDREQ_FLAG_REPLACEUsuń wykonuje i dodać zastąpienie bieżącego nagłówka.Nazwa nagłówka będzie używana do usunięcia bieżącego nagłówka i pełną wartość będzie używana, aby dodać nowy nagłówek.Jeśli występuje nagłówek wartość nagłówka jest pusty, jest usuwany.Jeśli nie zastępuje jest puste, wartość nagłówka.
HTTP_ADDREQ_FLAG_ADD_IF_NEWDodaje nagłówek tylko, jeśli jeszcze nie istnieje.Jeśli istnieje, zwracany jest błąd.
HTTP_ADDREQ_FLAG_ADDUżywane z ZAMIEŃ.Dodaje nagłówek, jeśli nie istnieje.
dwHeadersLen
Długość w znakach, z pstrHeaders.Jeśli następnie jest-1 L, pstrHeaders zakłada się zakończony zerem i długość jest obliczana.str
Odwołanie do CString obiekt zawierający żądanie nagłówka lub nagłówków, które mają zostać dodane.
Wartość zwracana
Niezerowa, jeśli kończy się pomyślnie; 0 inaczej.Jeżeli połączenie nie powiedzie się, funkcja Win32 GetLastError mogą być nazywane, aby ustalić przyczynę błędu.
Uwagi
AddRequestHeadersDołącza nagłówki dodatkowe, -format uchwytem żądania HTTP.Jest przeznaczony do użytku przez wyrafinowanych klientów potrzebujących szczegółową kontrolę nad dokładne żądania wysyłane do serwera HTTP.
[!UWAGA]
Aplikacji można przekazać wiele nagłówków w pstrHeaders lub str do AddRequestHeaders wywołanie przy użyciu HTTP_ADDREQ_FLAG_ADD lub HTTP_ADDREQ_FLAG_ADD_IF_NEW.Jeżeli aplikacja próbuje usunąć lub zastąpić za pomocą nagłówka HTTP_ADDREQ_FLAG_REMOVE lub HTTP_ADDREQ_FLAG_REPLACE, mogą być dostarczane tylko jeden nagłówek w lpszHeaders.
Wymagania
Nagłówek: afxinet.h