CHttpFile::AddRequestHeaders

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

BOOL &AddRequestHeaders (CStringamp ;strDWORDdwFlags= HTTP_ADDREQ_FLAG_ADD_IF_NEW);

Valeur de retour

Différent de zéro en cas de succès ; sinon 0. Si l'appel échoue, la fonction Win32 GetLastError peut être appelée pour déterminer la cause de l'erreur.

Paramètres

pstrHeaders

Un pointeur vers une chaîne contenant l'en-tête ou les en-têtes à ajouter à la demande. Chaque en-tête doit être terminé par une paire de CR/LF.

dwFlags

Modifie la sémantique des nouveaux en-têtes. Peut être l'une des opérations suivantes:

• HTTP_ADDREQ_FLAG_COALESCE  ;  Fusionne les en-têtes du même nom, à l'aide de l'indicateur pour ajouter l'en-tête premier trouvé à l'en-tête subséquente. Par exemple, "Accept : texte / * » suivie" Accept : audio / * » entraîne la formation de l'en-tête unique » accepter : texte / *, audio / * ». C'est à l'application appelante afin d'assurer un régime cohérent à l'égard des données reçues par des demandes envoyées avec en-têtes fusionnées ou séparés.
  
  
• HTTP_ADDREQ_FLAG_REPLACE  ;  Effectue un supprimer et ajouter pour remplacer l'en-tête actuel. Le nom d'en-tête sera utilisé pour supprimer l'en-tête actuel, et la pleine valeur servira à ajouter le nouvel en-tête. Si la valeur de l'en-tête est vide et l'en-tête se trouve, il est supprimé. Si non vide, la valeur de l'en-tête est remplacée.
  
  
• HTTP_ADDREQ_FLAG_ADD_IF_&NEWnbsp ;  Seulement ajoute l'en-tête si elle n'existe pas déjà. S'il existe, une erreur est retournée.
  
  
• HTTP_ADDREQ_FLAG_ADD  ;  Utilisé avec la remplacer. Ajoute l'en-tête si il n'existe pas.

dwHeadersLen

La longueur, en caractères, de pstrHeaders. Si c'est L-1, alors pstrHeaders est supposé pour être terminées à zéro et la longueur est calculée.

str

Une référence à un objet CString contenant l'en-tête de la demande ou les en-têtes à ajouter.

Remarques

Appelez cette fonction membre pour ajouter un ou plusieurs en-têtes de demande HTTP de la requête HTTP gérer.

AddRequestHeaders ajoute des en-têtes supplémentaires, format libre à la poignée de la demande HTTP. Il vise pour utilisation par les clients sophistiqués qui ont besoin d'un contrôle détaillé sur l'exacte demande envoyée au serveur HTTP.

&Notenbsp ;  L'application peut passer plusieurs en-têtes de pstrHeaders ou de str pour un appel de AddRequestHeaders à l'aide de HTTP_ADDREQ_FLAG_ADD ou HTTP_ADDREQ_FLAG_ADD_IF_NEW. Si l'application tente de supprimer ou de remplacer un en-tête à l'aide de HTTP_ADDREQ_FLAG_REMOVE ou HTTP_ADDREQ_FLAG_REPLACE, qu'un seul en-tête peut être fourni en lpszHeaders.

CHttpFile aperçu |  ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;CInternetFile