CHttpFile::AddRequestHeaders
Appelez la fonction membre pour ajouter un ou plusieurs en-têtes de requête HTTP pour gérer des requêtes 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
);
Paramètres
pstrHeaders
Un pointeur vers une chaîne contenant l'en-tête ou les en-têtes pour ajouter à la demande.Chaque en-tête doit être effectué par une paire de CHARIOT.dwFlags
Modifie la sémantique des nouveaux en-têtes.Il peut s'agir de l'une des valeurs suivantes :HTTP_ADDREQ_FLAG_COALESCE fusionne les en-têtes du même nom, à l'aide de l'indicateur pour ajouter le premier en-tête trouvé à l'en-tête suivant.Par exemple, « s'affiche : text/* » suivi de « reçoivent : audio/* » résultats dans la formation de l'en-tête unique « reçoivent : text/*, audio/* ».Il est jusqu'à l'application appelante de garantir un modèle cohésive par rapport à les données reçues par les demandes envoyées avec fusionné ou de séparer les en-têtes.
HTTP_ADDREQ_FLAG_REPLACE exécute un supprimer et ajoute pour remplacer l'en-tête actuel.Le nom d'en-tête est utilisé pour supprimer l'en-tête actuel, et la valeur totale sera utilisée pour ajouter le nouvel en-tête.Si la valeur d'en-tête est vide et l'en-tête est trouvé, il est supprimé.Sinon vide, la valeur d'en-tête est substituée.
HTTP_ADDREQ_FLAG_ADD_IF_NEW ajoute seulement l'en-tête s'il n'existe pas.Le cas échéant, une erreur est retournée.
HTTP_ADDREQ_FLAG_ADD celle utilisée avec SUBSTITUENT.Ajoute l'en-tête s'il n'existe pas.
dwHeadersLen
La longueur, en caractères, d' pstrHeaders.Si c'est -1L, alors considéré comme pstrHeaders zéro est terminé et la longueur est calculée.str
Une référence à un objet de CString contenant l'en-tête de demande ou les en-têtes à ajouter.
Valeur de retour
Une valeur différente de zéro si l'opération a réussi ; sinon 0.Si l'appel échoue, la fonction GetLastError Win32 peut être appelée pour déterminer la cause de l'erreur.
Notes
AddRequestHeaders ajoute en outre, les en-têtes de format libre pour gérer des requêtes HTTP.Il est prévu pour une utilisation par les clients sophistiqués qui ont besoin d'un contrôle détaillé de la demande spécifique envoyée au serveur HTTP.
[!REMARQUE]
L'application peut passer plusieurs en-têtes dans pstrHeaders ou str pour un appel d' AddRequestHeaders à l'aide de HTTP_ADDREQ_FLAG_ADD ou HTTP_ADDREQ_FLAG_ADD_IF_NEW.Si les tests d'application pour supprimer ou remplacer un en-tête à l'aide de HTTP_ADDREQ_FLAG_REMOVE ou HTTP_ADDREQ_FLAG_REPLACE, seul un en-tête peuvent être fournis dans lpszHeaders.
Configuration requise
Header: afxinet.h