Fonction HttpAddRequestHeadersW (wininet.h)
Ajoute un ou plusieurs en-têtes de requête HTTP au handle de requête HTTP.
Syntaxe
BOOL HttpAddRequestHeadersW(
[in] HINTERNET hRequest,
[in] LPCWSTR lpszHeaders,
[in] DWORD dwHeadersLength,
[in] DWORD dwModifiers
);
Paramètres
[in] hRequest
Handle retourné par un appel à la fonction HttpOpenRequest .
[in] lpszHeaders
Pointeur vers une variable de chaîne contenant les en-têtes à ajouter à la demande. Chaque en-tête doit être terminé par une paire CR/LF (retour chariot/saut de ligne).
[in] dwHeadersLength
Taille de lpszHeaders, en TCHAR. Si ce paramètre a la valeur -1L, la fonction suppose que lpszHeaders est terminé à zéro (ASCIIZ) et que la longueur est calculée.
[in] dwModifiers
Ensemble de modificateurs qui contrôlent la sémantique de cette fonction. Ce paramètre peut être une combinaison des valeurs suivantes.
Valeur retournée
Retourne TRUE en cas de réussite, ou FALSE dans le cas contraire. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.
Remarques
HttpAddRequestHeaders ajoute des en-têtes de format libre supplémentaires au handle de requête HTTP et est destiné aux clients sophistiqués qui ont besoin d’un contrôle détaillé sur la requête exacte envoyée au serveur HTTP.
Notez que pour les httpAddRequestHeaders de base, l’application peut passer plusieurs en-têtes dans une seule mémoire tampon. Si l’application tente de supprimer ou de remplacer un en-tête, un seul en-tête peut être fourni dans lpszHeaders.
Notes
L’en-tête wininet.h définit HttpAddRequestHeaders en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Configuration requise
Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | wininet.h |
Bibliothèque | Wininet.lib |
DLL | Wininet.dll |