CHttpFile::AddRequestHeaders
Chiamare la funzione membro per aggiungere uno o più intestazioni di richiesta HTTP all'handle della richiesta 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
);
Parametri
pstrHeaders
Un puntatore a una stringa contenente l'intestazione o intestazioni per associare alla richiesta. Ogni intestazione deve essere interrotta da una coppia di CR/LF.dwFlags
Modifica la semantica di nuove intestazioni. ad esempio uno dei seguenti:HTTP_ADDREQ_FLAG_COALESCE unisce le intestazioni dello stesso nome, utilizzando il flag per aggiungere la prima intestazione dell'intestazione successiva. Ad esempio, "accettare: text/*" seguito da "accettano: audio/*" risultati nella formazione di una singola intestazione "accettano: text/*, audio/*". Spetta all'applicazione chiamante fornire una combinazione coesiva relativo ai dati ricevuti dalle richieste inviate con unito o separare le intestazioni.
HTTP_ADDREQ_FLAG_REPLACE esegue un rimuovere e aggiunge per sostituire l'intestazione corrente. Il nome dell'intestazione verrà utilizzato per rimuovere l'intestazione corrente e il valore completo sarà utilizzato per aggiungere la nuova intestazione. Se il valore di intestazione è vuoto e l'intestazione viene trovata, viene rimossa. Se non è vuoto, il valore di intestazione verrà sostituito.
HTTP_ADDREQ_FLAG_ADD_IF_NEW aggiunge solo l'intestazione se non esiste già. Se presente, viene restituito un errore.
HTTP_ADDREQ_FLAG_ADD utilizzato con GLI SOSTITUZIONE. Aggiunge l'intestazione se non esiste.
dwHeadersLen
La lunghezza, i caratteri, pstrHeaders. Se è -1L, quindi pstrHeaders sia zero per essere terminato e la lunghezza viene calcolata.str
Un riferimento a un oggetto CString che contiene l'intestazione della richiesta o intestazioni da aggiungere.
Valore restituito
Diverso da zero se ha esito positivo; in caso contrario 0. Se la chiamata ha esito negativo, la funzione Win32 GetLastError può essere chiamata per determinare la causa dell'errore.
Note
AddRequestHeaders aggiunge aggiuntivo, intestazioni di formato libero all'handle della richiesta HTTP. Sono progettate per l'utilizzo da parte dei client avanzati che necessitano di un controllo dettagliato sulla corretta richiesta inviata al server HTTP.
Nota
L'applicazione può passare più intestazioni in pstrHeaders o in str per una chiamata AddRequestHeaders utilizzando HTTP_ADDREQ_FLAG_ADD o HTTP_ADDREQ_FLAG_ADD_IF_NEW.Se l'applicazione tenta di rimuovere o sostituire un'intestazione utilizzando HTTP_ADDREQ_FLAG_REMOVE o HTTP_ADDREQ_FLAG_REPLACE, solo un'intestazione può essere fornito in lpszHeaders.
Requisiti
Header: afxinet.h