Condividi tramite


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

Vedere anche

Riferimenti

Classe CHttpFile

Grafico delle gerarchie

Classe CInternetFile