CHttpFile::AddRequestHeaders
Volání funkce tohoto člena přidat nebo zpracovávat další záhlaví požadavku HTTP požadavku HTTP.
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
Ukazatel na řetězec obsahující záhlaví nebo záhlaví k žádosti připojit.Záhlaví musí být ukončena dvojice CR/LF.dwFlags
Upraví sémantiku nová záhlaví.Může být jeden z následujících:HTTP_ADDREQ_FLAG_COALESCEZáhlaví se stejným názvem, přidání záhlaví prvního nalezen další záhlaví pomocí příznak sloučení.Například "přijmout: text / *" následované "přijmout: audio / *" výsledkem je tvorba jedné hlavičce "přijmout: text / *, audio / *".Je volající aplikace zajistit soudržné schéma k dat přijatých žádostí odeslána s coalesced nebo samostatné záhlaví.
HTTP_ADDREQ_FLAG_REPLACEProvede odebrat a přidat k nahrazení aktuálního záhlaví.Název záhlaví bude použit k odebrání aktuálního záhlaví a plné hodnoty se použije k přidání nové hlavičky.Pokud je nalezen záhlaví hodnotu hlavičky je prázdný, je odebrána.Pokud není prázdný, nahrazuje hodnotu hlavičky.
HTTP_ADDREQ_FLAG_ADD_IF_NEWPřidá záhlaví, pouze pokud již neexistuje.Pokud existuje, je vrácena chyba.
HTTP_ADDREQ_FLAG_ADDPoužít nahradit.Přidá záhlaví, pokud neexistuje.
dwHeadersLen
Délka v znaků, z pstrHeaders .Pokud je L-1, pak pstrHeaders se zakončená nulou a délka je vypočítávána.str
Odkaz na CString objekt obsahující záhlaví požadavku nebo záhlaví, které chcete přidat.
Vrácená hodnota
Nenulová hodnota, pokud je úspěšná. jinak 0.Pokud selže volání funkce Win32 GetLastError může být volána zjistit příčinu chyby.
Poznámky
AddRequestHeaderspřipojí další, volný formát záhlaví požadavku popisovače HTTP.Je určen pro použití složitých klienty, kteří potřebují podrobnou kontrolu nad přesné požadavek odeslaný serveru HTTP.
[!POZNÁMKA]
Aplikace může předat více záhlaví v pstrHeaders nebo str pro AddRequestHeaders volání pomocí HTTP_ADDREQ_FLAG_ADD nebo HTTP_ADDREQ_FLAG_ADD_IF_NEW .Pokud aplikace pokusí odebrat nebo nahradit záhlaví pomocí HTTP_ADDREQ_FLAG_REMOVE nebo HTTP_ADDREQ_FLAG_REPLACE , lze zadat pouze jedno záhlaví v lpszHeaders .
Požadavky
Záhlaví: afxinet.h