Indicateurs d’option
Les indicateurs d’option suivants sont pris en charge par WinHttpQueryOption et WinHttpSetOption.
WINHTTP_OPTION_ASSURED_NON_BLOCKING_CALLBACKS
La valeur par défaut est FALSE. Si la valeur est TRUE, WinHTTP ne garantit pas la progression si status rappels sont bloqués par l’application cliente.
L’application cliente doit prendre une attention particulière pour effectuer des opérations minimales dans le rappel sans bloquer, retourner aussi rapidement que possible, et en particulier ne doit pas attendre les appels WinHTTP suivants. S’il ne suit pas ces instructions, il est probable qu’il y ait un impact négatif sur les performances ou un blocage potentiel de l’application. Si elle est utilisée de la manière prescrite, cette option peut améliorer les performances.
WINHTTP_OPTION_AUTOLOGON_POLICY
Définit une valeur entière longue non signée qui spécifie la stratégie d’ouverture de session automatique avec l’une des valeurs suivantes.
| Terme | Description |
|---|---|
| WINHTTP_AUTOLOGON_SECURITY_LEVEL_HIGH | Les informations d’identification par défaut ne sont pas utilisées. Notez que cet indicateur prend effet uniquement si vous spécifiez le serveur par le nom réel de l’ordinateur. Elle ne prend pas effet si vous spécifiez le serveur par « localhost » ou adresse IP. |
| WINHTTP_AUTOLOGON_SECURITY_LEVEL_LOW | Une ouverture de session authentifiée à l’aide des informations d’identification par défaut est effectuée pour toutes les demandes. |
| WINHTTP_AUTOLOGON_SECURITY_LEVEL_MEDIUM | Une ouverture de session authentifiée à l’aide des informations d’identification par défaut est effectuée uniquement pour les demandes sur l’intranet local. |
WINHTTP_OPTION_BACKGROUND_CONNECTIONS
Lorsque vous définissez cette option sur un handle de session, vous devez passer le nombre de connexions que vous souhaitez ouvrir. Ensuite, lors de l’envoi d’une demande, au lieu d’ouvrir une seule connexion, WinHttp ouvre un certain nombre de connexions en parallèle. Cela peut améliorer les performances des requêtes suivantes vers la même destination, qui n’aura pas la surcharge liée à l’établissement de la connexion.
WINHTTP_OPTION_CALLBACK
Récupère le pointeur vers l’ensemble de fonctions de rappel avec WinHttpSetStatusCallback.
WINHTTP_OPTION_CLIENT_CERT_CONTEXT
Définit le contexte du certificat client. Si une application reçoit ERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED, elle doit appeler WinHttpSetOption pour fournir un certificat avant de réessayer la demande. Dans le cadre du traitement de cette option, WinHttp appelle CertDuplicateCertificateContext sur le contexte de certificat fourni par l’appelant afin que le contexte de certificat puisse être libéré indépendamment par l’appelant.
Notes
L’application ne doit pas tenter de fermer le magasin de certificats avec l’indicateur CERT_CLOSE_STORE_FORCE_FLAG dans l’appel à CertCloseStore sur le magasin de certificats à partir duquel le contexte de certificat a été récupéré. Une violation d’accès peut se produire.
Lorsque le serveur demande un certificat client, WinHttpSendRequest ou WinHttpReceiveResponse retourne une erreur ERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED . Si le serveur demande le certificat mais n’en a pas besoin, l’application peut spécifier cette option pour indiquer qu’il n’a pas de certificat. Le serveur peut choisir un autre schéma d’authentification ou autoriser l’accès anonyme au serveur. L’application fournit la macro WINHTTP_NO_CLIENT_CERT_CONTEXT dans le paramètre lpBuffer de WinHttpSetOption , comme illustré dans l’exemple de code suivant.
BOOL fRet = WinHttpSetOption(hRequest,
WINHTTP_OPTION_CLIENT_CERT_CONTEXT,
WINHTTP_NO_CLIENT_CERT_CONTEXT,
0);
Si le serveur nécessite un certificat client, il peut envoyer un code de status HTTP 403 en réponse. Pour plus d’informations, consultez l’option WINHTTP_OPTION_CLIENT_CERT_ISSUER_LIST .
WINHTTP_OPTION_CLIENT_CERT_ISSUER_LIST
Récupère une structure de SecPkgContext_IssuerListInfoEx lorsque l’erreur de WinHttpSendRequest ou WinHttpReceiveResponse est ERROR_WINHTTP_CLIENT_AUTH_CERT_NEEDED. La liste des émetteurs dans la structure contient une liste d’autorités de certification acceptables à partir du serveur. L’application cliente peut filtrer la liste des autorités de certification pour récupérer le certificat client pour l’authentification SSL.
Sinon, si le serveur demande le certificat client, mais n’en a pas besoin, l’application peut appeler WinHttpSetOption avec l’option WINHTTP_OPTION_CLIENT_CERT_CONTEXT . Pour plus d’informations, consultez l’option WINHTTP_OPTION_CLIENT_CERT_CONTEXT .
WINHTTP_OPTION_CODEPAGE
Définit la page de codes utilisée pour traiter l’URL (c’est-à-dire la chaîne de requête). La valeur par défaut est UTF-8.
WINHTTP_OPTION_CONFIGURE_PASSPORT_AUTH
Définit une valeur entière longue non signée qui spécifie si l’authentification Passport dans l’authentification WinHTTP est activée. Il peut s'agir de l'une des valeurs suivantes :
| Terme | Description |
|---|---|
| WINHTTP_DISABLE_PASSPORT_AUTH | L’authentification Microsoft Passport est désactivée. Il s’agit de la valeur par défaut. |
| WINHTTP_DISABLE_PASSPORT_KEYRING | Le porte-clés Passport est désactivé. Il s’agit de la valeur par défaut. |
| WINHTTP_ENABLE_PASSPORT_AUTH | L’authentification Passport est activée. |
| WINHTTP_ENABLE_PASSPORT_KEYRING | Le porte-clés Passport est activé. |
WINHTTP_OPTION_CONNECT_RETRIES
Définit ou récupère une valeur entière longue non signée qui contient le nombre de tentatives de connexion deWinHTTP à un hôte. Microsoft Windows HTTP Services (WinHTTP) ne tente qu’une seule fois par adresse IP (Internet Protocol). Par exemple, si vous tentez de vous connecter à un hôte multi-hébergement qui a 10 adresses IP et que WINHTTP_OPTION_CONNECT_RETRIES est défini sur 7, WinHTTP tente uniquement de se connecter aux sept premières adresses IP. Dans le même ensemble de 10 adresses IP, si WINHTTP_OPTION_CONNECT_RETRIES a la valeur 20, WinHTTP n’essaie chacune des 10 qu’une seule fois. Si une tentative de connexion échoue toujours après le nombre spécifié de tentatives, ou si le délai d’expiration de connexion a expiré avant cette date, la demande est annulée. La valeur par défaut de WINHTTP_OPTION_CONNECT_RETRIES est de cinq tentatives.
WINHTTP_OPTION_CONNECT_TIMEOUT
Définit ou récupère une valeur entière longue non signée qui contient la valeur de délai d’attente, en millisecondes. La définition de cette option sur infini (0xFFFFFFFF) désactive ce minuteur.
Si une demande de connexion TCP prend plus de temps que cette valeur de délai d’attente, la requête est annulée. Le délai d’expiration par défaut est de 60 secondes. Lorsque vous tentez de vous connecter à plusieurs adresses IP pour un seul hôte (hôte multi-hébergement), la limite de délai d’expiration est pour chaque connexion individuelle.
WINHTTP_OPTION_CONNECTION_INFO
Récupère l’adresse IP source et de destination, ainsi que le port de la requête qui a généré la réponse lorsque WinHttpReceiveResponse est retourné. L’application appelle WinHttpQueryOption avec l’option WINHTTP_OPTION_CONNECTION_INFO et fournit la structure WINHTTP_CONNECTION_INFO dans le paramètre lpBuffer . Pour plus d’informations, consultez WINHTTP_CONNECTION_INFO.
S’applique à : Windows XP avec SP2 et versions ultérieures ; Windows 2003 avec SP1 et versions ultérieures.
WINHTTP_OPTION_CONNECTION_GUID
Marquez la connexion associée au handle de requête WinHTTP avec un GUID. Cela permet un contrôle personnalisé sur les demandes qui utilisent les groupes de connexions avec l’option WINHTTP_OPTION_MATCH_CONNECTION_GUID .
WINHTTP_OPTION_CONNECTION_STATS_V0
Retreive le struct TCP_INFO_v0 pour la connexion sous-jacente utilisée par la requête. Le struct retourné peut contenir des statistiques provenant de requêtes précédentes envoyées sur la même connexion.
Notes
Cette option a été remplacée par WINHTTP_OPTION_CONNECTION_STATS_V1.
WINHTTP_OPTION_CONNECTION_STATS_V1
Retreive le struct TCP_INFO_v1 pour la connexion sous-jacente utilisée par la requête. Le struct retourné peut contenir des statistiques provenant de requêtes précédentes envoyées sur la même connexion.
WINHTTP_OPTION_CONTEXT_VALUE
Définit ou récupère un DWORD_PTR qui contient un pointeur vers la valeur de contexte associée à ce handle HINTERNET . La valeur stockée dans la mémoire tampon est utilisée et une nouvelle valeur est affectée à l’indicateur d’option WINHTTP_OPTION_CONTEXT_VALUE .
WINHTTP_OPTION_DECOMPRESSION
Définit un DWORD d’indicateurs qui détermine si WinHTTP décompresse automatiquement les corps de réponse avec des encodages de contenu compressés. WinHTTP définit également un en-tête de Accept-Encoding approprié, en remplaçant tous les en-têtes fournis par l’appelant. Les valeurs prises en charge sont les suivantes :
| Terme | Description |
|---|---|
| WINHTTP_DECOMPRESSION_FLAG_GZIP | Décompresser l’encodage de contenu : réponses gzip. |
| WINHTTP_DECOMPRESSION_FLAG_DEFLATE | Décompresser l’encodage de contenu : dégonfler les réponses. |
| WINHTTP_DECOMPRESSION_FLAG_ALL | Décompressez les réponses avec n’importe quel encodage de contenu pris en charge. |
Par défaut, WinHTTP fournit des réponses compressées à l’appelant sans modification.
WINHTTP_OPTION_DISABLE_CERT_CHAIN_BUILDING
La définition de cette option sur un handle de session WinHttp vous permet d’activer/désactiver si la chaîne de certificats de serveur est générée.
WINHTTP_OPTION_DISABLE_FEATURE
Définit une valeur entière longue non signée qui spécifie les fonctionnalités qui sont désactivées avec un ou plusieurs des indicateurs suivants. N’oubliez pas que cette fonctionnalité ne doit être transmise à WinHttpSetOption sur les handles de demande qu’après la création du handle de demande avec WinHttpOpenRequest et avant que la demande ne soit envoyée avec WinHttpSendRequest.
| Terme | Description |
|---|---|
| WINHTTP_DISABLE_AUTHENTICATION | L’authentification automatique est désactivée. |
| WINHTTP_DISABLE_COOKIES | L’ajout automatique d’en-têtes de cookies aux requêtes est désactivé. En outre, les cookies retournés ne sont pas automatiquement ajoutés à la base de données des cookies. La désactivation des cookies peut entraîner des performances médiocres pour l’authentification Passport. |
| WINHTTP_DISABLE_KEEP_ALIVE | Désactive la sémantique keep-alive pour la connexion. La sémantique keep-alive est requise pour MSN, NTLM et d’autres types d’authentification. |
| WINHTTP_DISABLE_REDIRECTS | La redirection automatique est désactivée lors de l’envoi de requêtes avec WinHttpSendRequest. Si la redirection automatique est désactivée, une application doit inscrire une fonction de rappel pour que l’authentification Passport réussisse. |
WINHTTP_OPTION_DISABLE_GLOBAL_POOLING
Désactive le regroupement global entre sessions. Cette pratique est recommandée, car le regroupement global entre sessions est un comportement hérité pris en charge par défaut pour des raisons de compatibilité. Cela est affecté par la définition ultérieure du nombre maximal de connexions manuellement.
WINHTTP_OPTION_DISABLE_PROXY_AUTH_SCHEMES
Désactive une ou plusieurs des pratiques d’authentification de proxy suivantes sur la session WinHTTP en fournissant le OR de tous les choix applicables. Il s’agit de tous les schémas, à l’exception de WINHTTP_PROXY_DISABLE_AUTH_LOCAL_SERVICE, qui force l’utilisation du compte d’ordinateur local lors de l’envoi de requêtes à une adresse de bouclage ou locale. Cela empêche les fuites d’informations d’identification système vers des proxys HTTP locaux.
| Terme | Description |
|---|---|
| WINHTTP_PROXY_DISABLE_SCHEME_BASIC | Désactive le schéma d’authentification de base. |
| WINHTTP_PROXY_DISABLE_SCHEME_DIGEST | Désactive le schéma d’authentification Digest. |
| WINHTTP_PROXY_DISABLE_SCHEME_NTLM | Désactive le schéma d’authentification NTLM. |
| WINHTTP_PROXY_DISABLE_SCHEME_KERBEROS | Désactive le schéma d’authentification Kerberos. |
| WINHTTP_PROXY_DISABLE_SCHEME_NEGOTIATE | Désactive le schéma d’authentification Negotiate. |
| WINHTTP_PROXY_DISABLE_AUTH_LOCAL_SERVICE | Force l’utilisation du compte d’ordinateur local lors de l’envoi de requêtes à un bouclage ou à une adresse locale. |
WINHTTP_OPTION_DISABLE_SECURE_PROTOCOL_FALLBACK
Empêche WinHTTP de réessayer une connexion avec une version inférieure du protocole de sécurité lorsque la négociation initiale du protocole échoue.
WINHTTP_OPTION_DISABLE_STREAM_QUEUE
Permet aux nouvelles requêtes d’ouvrir une connexion HTTP/2 supplémentaire lorsque la limite maximale de flux simultané est atteinte, plutôt que d’attendre le flux disponible suivant sur une connexion existante.
WINHTTP_OPTION_ENABLE_FEATURE
Définit une valeur entière longue non signée qui spécifie les fonctionnalités actuellement activées. Il peut s’agir de l’une des valeurs suivantes.
| Terme | Description |
|---|---|
| WINHTTP_ENABLE_SSL_REVERT_IMPERSONATION | Si cette option est activée, WinHTTP rétablit temporairement l’emprunt d’identité du client pendant la durée des opérations d’authentification par certificat SSL. Cette valeur ne peut être définie que sur le handle de session. |
| WINHTTP_ENABLE_SSL_REVOCATION | Si cette option est activée, WinHTTP autorise la révocation SSL. Cette valeur ne peut être définie que sur le handle de requête. |
WINHTTP_OPTION_ENABLE_HTTP_PROTOCOL
Définit un masque de bits DWORD de versions HTTP avancées acceptables. Les valeurs possibles sont les suivantes :
| Terme | Description |
|---|---|
| WINHTTP_PROTOCOL_FLAG_HTTP2 (0x1) | Active HTTP/2 pour la requête. |
| WINHTTP_PROTOCOL_FLAG_HTTP3 (0x2) | Active HTTP/3 pour la requête. |
| Aucun (0x0) | Limite la requête à HTTP/1.1 et versions antérieures. |
Les versions héritées de HTTP (1.1 et antérieures) ne peuvent pas être désactivées à l’aide de cette option. La valeur par défaut est 0x0.
WINHTTP_OPTION_ENABLE_HTTP2_PLUS_CLIENT_CERT
Cette option peut être définie sur un handle de session WinHttp pour permettre à WinHttp d’utiliser le contexte de certificat client fourni par l’appelant lors de l’utilisation de HTTP/2.
WINHTTP_OPTION_ENABLETRACING
Définit une valeur BOOL qui spécifie si le suivi est actuellement activé. Cette option ne peut être définie que sur un handle HINTERNETNULL. Consultez également Collecter des traces WinHTTP.
WINHTTP_OPTION_ENCODE_EXTRA
Active l’encodage du pourcentage d’URL pour le chemin d’accès et la chaîne de requête.
Vous pouvez également encoder en pourcentage avant d’appeler WinHttp.
WINHTTP_OPTION_EXPIRE_CONNECTION
Cette option ne peut être définie que sur un handle de demande qui est toujours actif (envoi ou réception). La définition de cette option indique à WinHttp d’arrêter de traiter les demandes sur la connexion associée au handle de requête transmis. La connexion sera fermée une fois que le handle de demande avec lequel cette option est appelée est terminé. Cette option ne prend aucun paramètre.
WINHTTP_OPTION_EXTENDED_ERROR
Récupère une valeur entière longue non signée qui contient un code d’erreur Microsoft Windows Sockets qui a été mappé aux messages d’erreur ERROR_WINHTTP_* retournés pour la dernière fois dans ce contexte de thread. Vous pouvez passer NULL comme valeur de handle.
WINHTTP_OPTION_FEATURE_SUPPORTED
Vérifiez si un indicateur d’option fourni est pris en charge par cette version de WinHTTP.
WINHTTP_OPTION_FIRST_AVAILABLE_CONNECTION
Par défaut, lorsque WinHttp envoie une requête, s’il n’existe aucune connexion disponible pour traiter la demande, WinHttp tente d’établir une nouvelle connexion et la demande est liée à cette nouvelle connexion. Lorsque vous définissez cette option, une telle demande est traitée à la place sur la première connexion qui devient disponible, et pas nécessairement sur celle en cours d’établissement.
WINHTTP_OPTION_GLOBAL_PROXY_CREDS
Prend un pointeur vers une structure WINHTTP_CREDS_EX avec le paramètre de fonction hInternet défini sur NULL. Cette option nécessite la clé de Registre HKLM\Software\Microsoft\Windows\CurrentVersion\Internet Settings! ShareCredsWithWinHttp. Si cette clé de Registre n’est pas définie, WinHTTP renvoie l’erreur ERROR_WINHTTP_INVALID_OPTION. Cette clé de Registre n’est pas présente par défaut. Lorsqu’il est défini, WinINet envoie les informations d’identification à WinHTTP. Chaque fois que WinHttp obtient une demande d’authentification et si aucune information d’identification n’est définie sur le handle actuel, il utilise les informations d’identification fournies par WinINet. Pour partager les informations d’identification du serveur en plus des informations d’identification de proxy, les utilisateurs doivent définir WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS .
WINHTTP_OPTION_GLOBAL_SERVER_CREDS
Prend un pointeur vers une structure WINHTTP_CREDS_EX avec le paramètre de fonction hInternet défini sur NULL. Cette option nécessite la clé de Registre HKLM\Software\Microsoft\Windows\CurrentVersion\Internet Settings! ShareCredsWithWinHttp. Si cette clé de Registre n’est pas définie, WinHTTP renvoie l’erreur ERROR_WINHTTP_INVALID_OPTION. Cette clé de Registre n’est pas présente par défaut. Lorsqu’il est défini, WinINet envoie les informations d’identification à WinHTTP. Chaque fois que WinHttp obtient une demande d’authentification et si aucune information d’identification n’est définie sur le handle actuel, il utilise les informations d’identification fournies par WinINet. Pour partager les informations d’identification du serveur en plus des informations d’identification de proxy, les utilisateurs doivent définir WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS .
WINHTTP_OPTION_HANDLE_TYPE
Récupère une valeur entière longue non signée qui contient le type du handle HINTERNET passé. La valeur de retour peut être une des suivantes :
| Terme | Description |
|---|---|
| WINHTTP_HANDLE_TYPE_CONNECT | Le handle est un handle de connexion. |
| WINHTTP_HANDLE_TYPE_REQUEST | Le handle est un handle de requête. |
| WINHTTP_HANDLE_TYPE_SESSION | Le handle est un handle de session. |
WINHTTP_OPTION_HTTP_PROTOCOL_REQUIRED
Empêche l’utilisation de versions de protocole autres que celles activées par WINHTTP_OPTION_ENABLE_HTTP_PROTOCOL pour la demande.
WINHTTP_OPTION_HTTP_PROTOCOL_USED
Obtient un DWORD indiquant quelle version HTTP avancée a été utilisée sur une requête donnée. Pour obtenir la liste des valeurs possibles, consultez WINHTTP_OPTION_ENABLE_HTTP_PROTOCOL.
WINHTTP_OPTION_HTTP_VERSION
Définit ou récupère une structure HTTP_VERSION_INFO qui contient la version HTTP prise en charge. Il s’agit d’une option à l’échelle du processus ; utilisez NULL pour le handle.
WINHTTP_OPTION_HTTP2_KEEPALIVE
Cette option peut être définie sur un handle de session pour que WinHttp utilise des trames PING HTTP/2 comme mécanisme de conservation. Les appelants spécifient un délai d’expiration en millisecondes, et une fois qu’il n’y a aucune activité sur une connexion pour ce délai d’expiration, WinHttp commence à envoyer des trames PING HTTP/2. Les appelants ne peuvent pas définir une valeur de délai d’expiration inférieure à 5 000 millisecondes.
WINHTTP_OPTION_HTTP2_PLUS_TRANSFER_ENCODING
Cette option peut être définie sur un handle de requête WinHttp pour contrôler le comportement de WinHttp lorsqu’une réponse HTTP/2 contient un en-tête « Transfer-Encoding ». Dans ce cas, WinHttp renvoie une erreur si cette option a la valeur FALSE.
WINHTTP_OPTION_HTTP2_RECEIVE_WINDOW
Définissez la taille de la fenêtre de réception de flux HTTP/2 initiale et le seuil d’envoi des mises à jour de fenêtre à l’aide du struct WINHTTP_HTTP2_RECEIVE_WINDOW .
WINHTTP_OPTION_HTTP3_HANDSHAKE_TIMEOUT
Utilise la mémoire tampon pour définir le délai d’expiration de l’établissement d’une liaison HTTP/3 en millisecondes en tant que PDWORD.
WINHTTP_OPTION_HTTP3_INITIAL_RTT
Configure le RTT initial en millisecondes utilisé par msquic.
WINHTTP_OPTION_HTTP3_KEEPALIVE
Active la sémantique keep-alive pour la connexion. Utilise la mémoire tampon pour définir le délai d’expiration de la durée de vie en millisecondes en tant que PDWORD.
WINHTTP_OPTION_HTTP3_STREAM_ERROR_CODE
Récupère l’erreur fournie par le serveur sur le flux HTTP/3 utilisé pour envoyer la requête.
WINHTTP_OPTION_IGNORE_CERT_REVOCATION_OFFLINE
Permet aux connexions sécurisées d’utiliser des certificats de sécurité pour lesquels la liste de révocation de certificats n’a pas pu être téléchargée.
WINHTTP_OPTION_IPV6_FAST_FALLBACK
Active le secours rapide IPv6 (Happier Eyeballs) pour la connexion. Ce comportement est similaire au comportement happy eyeballs décrit dans RFC 6555 pour améliorer les temps de connexion sur les réseaux où IPv6 n’est pas fiable.
- Si les adresses IPv6 et IPv4 sont résolues pour un hôte donné, WinHttp commence par se connecter à la première adresse IPv6 résolue avec un délai d’expiration court (300 ms).
- Si cette connexion échoue, WinHttp tente de se connecter à la première adresse IPv4 résolue avec le délai d’expiration standard.
- Si la deuxième connexion échoue, WinHttp réessaye la première adresse IPv6 résolue avec le délai d’expiration standard.
- Si la troisième connexion échoue, WinHttp rétablit le comportement par défaut pour toutes les adresses restantes, en essayant une connexion à chacune d’elles avec le délai d’expiration standard jusqu’à ce qu’une connexion soit établie ou qu’aucune adresse ne soit conservée.
WINHTTP_OPTION_IS_PROXY_CONNECT_RESPONSE
Obtient si une réponse de connexion de retour de proxy peut être récupérée ou non.
WINHTTP_OPTION_MATCH_CONNECTION_GUID
Prend un struct WINHTTP_MATCH_CONNECTION_GUID pour indiquer à WinHTTP de traiter la requête sur une connexion correspondante. Si WINHTTP_MATCH_CONNECTION_GUID_FLAG_REQUIRED est défini, seules les connexions avec un GUID correspondant peuvent être utilisées. Sinon, les connexions avec des GUID correspondants et les connexions qui ne sont marquées avec aucun GUID peuvent être utilisées.
WINHTTP_OPTION_MAX_CONNS_PER_1_0_SERVER
Définit ou récupère une valeur entière longue non signée qui contient le nombre maximal de connexions autorisées par serveur HTTP/1.0. La valeur par défaut est INFINITE.
S’applique à : Windows Vista avec SP1 et versions ultérieures ; Windows Server 2008 et versions ultérieures.
WINHTTP_OPTION_MAX_CONNS_PER_SERVER
Définit ou récupère une valeur entière longue non signée qui contient le nombre maximal de connexions autorisées par serveur. La valeur par défaut est INFINITE.
Lorsque cette option est définie sur zéro, WinHTTP définit la limite du nombre de connexions sur 2.
WINHTTP_OPTION_MAX_HTTP_AUTOMATIC_REDIRECTS
Définit le nombre maximal de redirections que WinHTTP suit ; la valeur par défaut est 10. Cette limite empêche les sites non autorisés de suspendre le client WinHTTP après un grand nombre de redirections.
S’applique à : Windows XP avec SP1 et versions ultérieures ; Windows 2000 avec SP3 et versions ultérieures.
WINHTTP_OPTION_MAX_HTTP_STATUS_CONTINUE
Nombre maximal de réponses de code informationnelles 100-199 status ignorées avant de retourner le code status final au client WinHTTP. Les codes d’information 100-199 status peuvent être envoyés par le serveur avant le code status final et sont décrits dans la spécification pour HTTP/1.1 (pour plus d’informations, voir RFC 2616). La valeur par défaut est de 10.
S’applique à : Windows XP avec SP1 et versions ultérieures ; Windows 2000 avec SP3 et versions ultérieures.
WINHTTP_OPTION_MAX_RESPONSE_DRAIN_SIZE
lié à la quantité de données vidées des réponses afin de réutiliser une connexion, spécifiée en octets. La valeur par défaut est 1 Mo.
S’applique à : Windows XP avec SP1 et versions ultérieures ; Windows 2000 avec SP3 et versions ultérieures.
WINHTTP_OPTION_MAX_RESPONSE_HEADER_SIZE
Ensemble lié à la taille maximale de la partie d’en-tête de la réponse du serveur, spécifiée en octets. Cette liaison protège le client contre un serveur non autorisé qui tente de bloquer le client en envoyant une réponse avec une quantité infinie de données d’en-tête. La valeur par défaut est 64 Ko.
S’applique à : Windows XP avec SP1 et versions ultérieures ; Windows 2000 avec SP3 et versions ultérieures.
WINHTTP_OPTION_PARENT_HANDLE
Récupère le handle parent de ce handle.
WINHTTP_OPTION_PASSPORT_COBRANDING_TEXT
Récupère une chaîne qui contient le texte de cobranding fourni par le serveur d’ouverture de session Passport. Cette option doit être récupérée immédiatement après la réponse du serveur d’ouverture de session avec un code status 401. Une application doit passer une taille de mémoire tampon, en octets, suffisamment grande pour contenir la chaîne retournée.
WINHTTP_OPTION_PASSPORT_COBRANDING_URL
Récupère une chaîne qui contient une URL pour un graphique de cobranding fourni par le serveur d’ouverture de session Passport. Cette option doit être récupérée immédiatement après la réponse du serveur d’ouverture de session avec un code 401 status. Une application doit passer une taille de mémoire tampon, en octets, suffisamment grande pour contenir la chaîne retournée.
WINHTTP_OPTION_PASSPORT_RETURN_URL
Définit une option en lecture seule sur un handle de demande qui récupère l’URL de retour Passport.
WINHTTP_OPTION_PASSPORT_SIGN_OUT
Définit l’option sur un handle de session pour se déconnecter de toutes les connexions Passport. Une application doit transmettre l’URL de retour Passport qui a été récupérée avec WINHTTP_OPTION_PASSPORT_RETURN_URL. Tous les cookies liés à l’URL de retour sont effacés.
WINHTTP_OPTION_PASSWORD
Définit ou récupère une valeur de chaîne qui contient le mot de passe associé à un handle de requête.
WINHTTP_OPTION_PROXY
Définit ou récupère une structure de WINHTTP_PROXY_INFO qui contient les données proxy sur un handle de session ou un handle de requête existant. Lors de la récupération des données proxy, une application doit libérer les chaînes lpszProxy et lpszProxyBypass contenues dans cette structure (si elles ne sont pas NULL) à l’aide de la fonction GlobalFree . Une application peut interroger les données du proxy global (proxy par défaut) en transmettant un handle NULL .
WINHTTP_OPTION_PROXY_PASSWORD
Définit ou récupère une valeur de chaîne qui contient le mot de passe utilisé pour accéder au proxy.
WINHTTP_OPTION_PROXY_SPN_USED
Obtient le nom du principal du serveur proxy que WinHTTP a fourni à SSPI lors de l’authentification. Cette valeur de chaîne est utilisée pour passer à SspiPromptForCredentials après un échec d’authentification.
WINHTTP_OPTION_PROXY_USERNAME
Définit ou récupère une valeur de chaîne qui contient le nom d’utilisateur utilisé pour accéder au proxy.
WINHTTP_OPTION_QUIC_STATS
Récupère une structure QUIC_STATISTICS qui contient des informations de connexion telles que RTT et les octets envoyés et reçus.
WINHTTP_OPTION_READ_BUFFER_SIZE
Cette option est déconseillée ; elle n’a aucun effet.
WINHTTP_OPTION_RECEIVE_PROXY_CONNECT_RESPONSE
Définit si l’entité de réponse proxy peut être récupérée ou non. qui est désactivée par défaut.
WINHTTP_OPTION_RECEIVE_RESPONSE_TIMEOUT
Définit ou récupère une valeur entière longue non signée qui contient la valeur de délai d’attente, en millisecondes, pour attendre de recevoir tous les en-têtes de réponse à une requête. Si WinHTTP ne parvient pas à recevoir tous les en-têtes au cours de ce délai d’expiration, la demande est annulée. La valeur de délai d’expiration par défaut est de 90 secondes.
Ce délai d’attente est vérifié uniquement lorsque des données sont reçues du socket. Par conséquent, lorsque le délai d’expiration expire, l’application cliente n’est pas avertie tant que d’autres données n’arrivent pas du serveur. Si aucune donnée n’arrive du serveur, le délai entre l’expiration du délai d’expiration et la notification de l’application cliente peut être aussi important que la valeur de délai d’expiration définie à l’aide du paramètre dwReceiveTimeout de la fonction WinHttpSetTimeouts .
WINHTTP_OPTION_RECEIVE_TIMEOUT
Définit ou récupère une valeur entière longue non signée qui contient la valeur de délai d’attente, en millisecondes, pour recevoir une réponse partielle à une requête ou lire certaines données. Si la réponse prend plus de temps que cette valeur de délai d’attente, la demande est annulée. La valeur de délai d'attente par défaut est de 30 secondes.
WINHTTP_OPTION_REDIRECT_POLICY
Définit le comportement de WinHTTP concernant la gestion d’une redirection HTTP 30x status code. Cette option peut être définie sur un handle de session ou de requête sur l’une des valeurs suivantes :
| Terme | Description |
|---|---|
| WINHTTP_OPTION_REDIRECT_POLICY_ALWAYS | Toutes les redirections sont suivies automatiquement. |
| WINHTTP_OPTION_REDIRECT_POLICY_DISALLOW_HTTPS_TO_HTTP | Toutes les redirections sont suivies, à l’exception de celles qui proviennent d’une URL sécurisée (https) vers une URL non sécurisée (http). Il s'agit du paramètre par défaut. |
| WINHTTP_OPTION_REDIRECT_POLICY_NEVER | Les redirections ne sont jamais suivies. Le status 30x est retourné à l’application. |
WINHTTP_OPTION_REJECT_USERPWD_IN_URL
Rejette les URL qui contiennent un nom d’utilisateur et un mot de passe. Cette option rejette également les URL qui contiennent la sémantique nom d’utilisateur:mot de passe , même si aucun nom d’utilisateur ou mot de passe n’est spécifié. Par exemple, « u:p@hostname », « :@hostname », « u:@hostname » et « :p@nom d’hôte » sont tous marqués comme non valides. Si une URL non valide est passée à la fonction, elle retourne ERROR_WINHTTP_INVALID_URL. Cette option est désactivée par défaut.
WINHTTP_OPTION_REQUEST_ANNOTATION
Permet d’obtenir et de définir une annotation de requête pour le nom d’annotation fourni. Cela permet à l’appelant d’attacher une chaîne à la demande de récupération ultérieure afin d’identifier les demandes par n’importe quelle logique personnalisée que l’appelant trouve utile.
WINHTTP_OPTION_REQUEST_PRIORITY
Cette option est déconseillée ; elle n’a aucun effet.
WINHTTP_OPTION_REQUEST_STATS
Retreive les statistiques pour la demande. Pour obtenir la liste des statistiques disponibles, consultez WINHTTP_REQUEST_STATS.
WINHTTP_OPTION_REQUEST_TIMES
Retreive les informations de minutage de la demande. Pour obtenir la liste des délais disponibles, consultez WINHTTP_REQUEST_TIMES.
WINHTTP_OPTION_REQUIRE_STREAM_END
Cette option indique à WinHttp d’ignorer les en-têtes de réponse « Content-Length » et de continuer à recevoir sur un flux jusqu’à ce que l’indicateur END_STREAM soit reçu.
WINHTTP_OPTION_RESOLUTION_HOSTNAME
Cette option peut être définie sur un handle de requête WinHttp avant son envoi. Si la valeur est définie, WinHttp utilise la chaîne fournie par l’appelant comme nom d’hôte pour la résolution DNS.
WINHTTP_OPTION_RESOLVE_TIMEOUT
Définit ou récupère une valeur entière longue non signée qui contient la valeur de délai d’attente, en millisecondes, pour résoudre un nom d’hôte. La valeur de délai d’expiration par défaut est INFINITE. Si une valeur autre que celle par défaut est spécifiée, une surcharge est liée à la création d’un thread par résolution de noms.
WINHTTP_OPTION_REVERT_IMPERSONATION_SERVER_CERT
Rétablit toute emprunt d’identité de thread lors de la génération de la chaîne de certificats de serveur, forçant l’utilisation du jeton de processus à la place.
WINHTTP_OPTION_SECURE_PROTOCOLS
Définit une valeur entière longue non signée qui spécifie les protocoles sécurisés acceptables.
- Windows 11, Windows 10 et Windows 8.1. Par défaut, seuls SSL3, TLS1.0, TLS1.1 et TLS1.2 sont activés.
- Windows 8 et Windows 7. Par défaut, seuls SSL3 et TLS1 sont activés.
La valeur peut être une combinaison d’une ou plusieurs des valeurs suivantes.
| Terme | Description |
|---|---|
| WINHTTP_FLAG_SECURE_PROTOCOL_ALL | Les protocoles SSL (Secure Sockets Layer) 2.0, SSL 3.0 et TLS (Transport Layer Security) 1.0 peuvent être utilisés. |
| WINHTTP_FLAG_SECURE_PROTOCOL_SSL2 | Le protocole SSL 2.0 peut être utilisé. |
| WINHTTP_FLAG_SECURE_PROTOCOL_SSL3 | Le protocole SSL 3.0 peut être utilisé. |
| WINHTTP_FLAG_SECURE_PROTOCOL_TLS1 | Le protocole TLS 1.0 peut être utilisé. |
| WINHTTP_FLAG_SECURE_PROTOCOL_TLS1_1 | Le protocole TLS 1.1 peut être utilisé. |
| WINHTTP_FLAG_SECURE_PROTOCOL_TLS1_2 | Le protocole TLS 1.2 peut être utilisé. |
| WINHTTP_FLAG_SECURE_PROTOCOL_TLS1_3 | Le protocole TLS 1.3 peut être utilisé. |
Si vous devez ajouter la prise en charge des protocoles TLS 1.1 ou TLS 1.2, mais que vous ne pouvez pas recompiler votre application pour utiliser les valeurs appropriées de WINHTTP_OPTION_SECURE_PROTOCOLS, vous pouvez ajouter l’entrée de Registre à la DefaultSecureProtocols place. Cette entrée de Registre vous permet de spécifier les protocoles SSL à utiliser lorsque l’indicateur WINHTTP_OPTION_SECURE_PROTOCOLS est utilisé.
Important
Les instructions ci-dessous impliquent la modification du Registre. Toutefois, des problèmes importants peuvent survenir si vous modifiez le registre de façon incorrecte. Par conséquent, veillez à suivre attentivement ces instructions. Pour plus de protection, sauvegardez le registre avant de le modifier. Vous pourrez ainsi restaurer le Registre en cas de problème. Pour plus d’informations sur la sauvegarde et la restauration du Registre, consultez Comment sauvegarder et restaurer le Registre dans Windows.
Lorsqu’une application spécifie WINHTTP_OPTION_SECURE_PROTOCOLS, le système recherche l’entrée de DefaultSecureProtocols Registre et, le cas échéant, remplace les protocoles par défaut spécifiés par WINHTTP_OPTION_SECURE_PROTOCOLS par les protocoles spécifiés dans l’entrée de DefaultSecureProtocols Registre. Si l’entrée de Registre n’est pas présente, WinHTTP utilise les valeurs par défaut du système d’exploitation existantes pour WINHTTP_OPTION_SECURE_PROTOCOLS. Ces valeurs par défaut WinHTTP suivent les règles de précédence existantes et sont écrasées par les protocoles et protocoles désactivés du canal sécurisé (Schannel) définis par application par WinHttpSetOption.
Vous pouvez ajouter l’entrée de DefaultSecureProtocols Registre dans le chemin d’accès suivant :
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Internet Settings\WinHttp
Sur les ordinateurs x64, vous devez également ajouter DefaultSecureProtocols au chemin d’accès Wow6432Node :
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Windows\CurrentVersion\Internet Settings\WinHttp
La valeur de Registre est une bitmap DWORD. La valeur à utiliser est déterminée en ajoutant les valeurs correspondant aux protocoles souhaités.
| Valeur DefaultSecureProtocols | Protocole activé |
|---|---|
| 0x00000008 | Activer SSL 2.0 par défaut |
| 0x00000020 | Activer SSL 3.0 par défaut |
| 0x00000080 | Activer TLS 1.0 par défaut |
| 0x00000200 | Activer TLS 1.1 par défaut |
| 0x00000800 | Activer TLS 1.2 par défaut |
Par exemple, si vous souhaitez remplacer les valeurs par défaut pour WINHTTP_OPTION_SECURE_PROTOCOLS de spécifier TLS 1.1 et TLS 1.2. Dans ce cas, prenez la valeur de TLS 1.1 (0x00000200) et la valeur de TLS 1.2 (0x00000800), ajoutez-les ensemble dans la calculatrice (en mode programmeur) et la valeur de Registre résultante serait 0x00000A00.
WINHTTP_OPTION_SECURITY_CERTIFICATE_STRUCT
Récupère le certificat d’un serveur SSL/TLS dans la structure WINHTTP_CERTIFICATE_INFO . L’application doit libérer les membres lpszSubjectInfo et lpszIssuerInfo avec LocalFree.
WINHTTP_OPTION_SECURITY_FLAGS
Définit ou récupère une valeur entière longue non signée qui contient les indicateurs de sécurité d’un handle. Il peut s’agir d’une combinaison de ces valeurs :
| Terme | Description |
|---|---|
| SECURITY_FLAG_IGNORE_CERT_CN_INVALID | Autorise un nom commun non valide dans un certificat ; autrement dit, le nom de serveur spécifié par l’application ne correspond pas au nom commun dans le certificat. Si cet indicateur est défini, l’application ne reçoit pas de rappel WINHTTP_CALLBACK_STATUS_FLAG_CERT_CN_INVALID . |
| SECURITY_FLAG_IGNORE_CERT_DATE_INVALID | Autorise une date de certificat non valide, c’est-à-dire un certificat expiré ou non encore effectif. Si cet indicateur est défini, l’application ne reçoit pas de rappel WINHTTP_CALLBACK_STATUS_FLAG_CERT_DATE_INVALID . |
| SECURITY_FLAG_IGNORE_UNKNOWN_CA | Autorise une autorité de certification non valide. Si cet indicateur est défini, l’application ne reçoit pas de rappel WINHTTP_CALLBACK_STATUS_FLAG_INVALID_CA . |
| SECURITY_FLAG_IGNORE_CERT_WRONG_USAGE | Permet d’établir l’identité d’un serveur avec un certificat non-serveur (par exemple, un certificat client). |
| SECURITY_FLAG_IGNORE_WEAK_SIGNATURE | Permet d’ignorer une signature faible. Cet indicateur est disponible dans la mise à jour cumulative pour chaque système d’exploitation à partir de Windows 7 et Windows Server 2008 R2. |
| SECURITY_FLAG_SECURE | Utilise des transferts sécurisés. Cette valeur est uniquement retournée dans un appel à WinHttpQueryOption. |
| SECURITY_FLAG_STRENGTH_MEDIUM | Utilise un chiffrement moyen (56 bits). Cette valeur est uniquement retournée dans un appel à WinHttpQueryOption. |
| SECURITY_FLAG_STRENGTH_STRONG | Utilise un chiffrement fort (128 bits). Cette valeur est uniquement retournée dans un appel à WinHttpQueryOption. |
| SECURITY_FLAG_STRENGTH_WEAK | Utilise un chiffrement faible (40 bits). Cette valeur est uniquement retournée dans un appel à WinHttpQueryOption. |
WINHTTP_OPTION_SECURITY_INFO
Récupère les informations de chiffrement et de connexion SChannel pour une demande.
WINHTTP_OPTION_SECURITY_KEY_BITNESS
Récupère une valeur entière longue non signée qui contient la force de chiffrement de la clé de chiffrement. Un nombre plus élevé indique un chiffrement de force de chiffrement plus fort.
WINHTTP_OPTION_SEND_TIMEOUT
Définit ou récupère une valeur entière longue non signée qui contient la valeur de délai d’attente, en millisecondes, pour envoyer une demande ou écrire des données. Si l’envoi de la demande prend plus de temps que le délai d’expiration, l’opération d’envoi est annulée. Le délai d’expiration par défaut est de 30 secondes.
WINHTTP_OPTION_SERVER_CBT
Obtient un pointeur vers SecPkgContext_Bindings structure qui spécifie un jeton de liaison de canal (CBT).
Un jeton de liaison de canal est une propriété d’un canal de transport sécurisé et est utilisé pour lier un canal d’authentification au canal de transport sécurisé. Ce jeton ne peut être obtenu par cette option qu’après l’établissement d’une connexion SSL.
Notes
Le passage de cette option et d’une valeur null pour lpBuffer à WinHttpQueryOption retourne ERROR_INSUFFICIENT_BUFFER et la taille d’octet requise pour la mémoire tampon dans le paramètre lpdwBufferLength . Cette valeur de taille de mémoire tampon retournée peut être passée dans un appel ultérieur pour interroger le jeton de liaison de canal. Ces étapes sont nécessaires lors de la gestion des WINHTTP_CALLBACK_STATUS_REQUEST si vous souhaitez modifier les en-têtes de requête en fonction du jeton de liaison de canal. Notez que Windows XP et Vista ne prennent pas en charge la modification des en-têtes de requête pendant ce rappel.
WINHTTP_OPTION_SERVER_CERT_CHAIN_CONTEXT
Récupère le contexte de chaîne de certification du serveur. WINHTTP_OPTION_SERVER_CERT_CHAIN_CONTEXT peuvent être passés pour obtenir un pointeur dupliqué vers le CERT_CHAIN_CONTEXT pour une chaîne de certificats de serveur reçue lors d’une connexion SSL négociée. Le client doit appeler CertFreeCertificateContext sur le pointeur de PCCERT_CONTEXT retourné qui est rempli dans la mémoire tampon.
WINHTTP_OPTION_SERVER_CERT_CONTEXT
Récupère le contexte de certification du serveur. WINHTTP_OPTION_SERVER_CERT_CONTEXT peuvent être passés pour obtenir un pointeur dupliqué vers le contexte de certificat de certificat pour un certificat de serveur reçu lors d’une connexion SSL négociée. Le client doit appeler CertFreeCertificateContext sur le pointeur de PCCERT_CONTEXT retourné qui est rempli dans la mémoire tampon.
WINHTTP_OPTION_SERVER_SPN_USED
Obtient le nom du principal du serveur que WinHTTP a fourni à SSPI lors de l’authentification. Cette valeur de chaîne peut être transmise à SspiPromptForCredentials après un échec d’authentification.
WINHTTP_OPTION_SPN
Inclut ou supprime le numéro de port du serveur lorsque le SPN (nom du principal de service) est généré pour l’authentification Kerberos ou négocier l’authentification Kerberos. Cet indicateur est l’une des valeurs suivantes :
| Terme | Description |
|---|---|
| WINHTTP_DISABLE_SPN_SERVER_PORT | Supprime le numéro de port du serveur. |
| WINHTTP_ENABLE_SPN_SERVER_PORT | Inclut le numéro de port du serveur. |
WINHTTP_OPTION_STREAM_ERROR_CODE
Cette option peut être interrogée sur un handle de requête WinHttp et retourne le code d’erreur indiqué par une image RST_STREAM reçue sur un flux HTTP.
WINHTTP_OPTION_TCP_FAST_OPEN
Active TCP Fast Open pour la connexion.
WINHTTP_OPTION_TCP_KEEPALIVE
Cette option peut être définie sur un handle de session WinHttp pour activer le comportement de conservation TCP sur le socket sous-jacent. Prend un struct tcp_keepalive .
WINHTTP_OPTION_TLS_FALSE_START
Active le faux démarrage TLS pour la connexion.
WINHTTP_OPTION_TCP_PRIORITY_STATUS
Interrogez la priorité suggérée du jeu de sockets TCP avec WINHTTP_OPTION_TCP_PRIORITY_HINT. Pour plus d’informations, consultez la documentation relative aux SIO_SET_PRIORITY_HINT .
WINHTTP_OPTION_TLS_PROTOCOL_INSECURE_FALLBACK
Cette option peut être définie sur un handle de session WinHttp pour contrôler si le secours à TLS 1.0 est autorisé en cas d’échec de l’établissement d’une liaison TLS avec une version de protocole plus récente.
WINHTTP_OPTION_UNLOAD_NOTIFY_EVENT
Prend un événement qui sera défini lorsque le dernier rappel est terminé pour une session particulière. Cet indicateur doit être utilisé sur un handle de session. L’événement ne peut pas être fermé tant qu’il n’a pas été défini par WinHTTP.
WINHTTP_OPTION_UNSAFE_HEADER_PARSING
Cette option est réservée à un usage interne et ne doit pas être appelée.
WINHTTP_OPTION_UPGRADE_TO_WEB_SOCKET
Indique à la pile de démarrer un processus d’établissement de liaison WebSocket avec WinHttpSendRequest. Cette option ne prend aucun paramètre.
WINHTTP_OPTION_URL
Récupère une valeur de chaîne qui contient l’URL complète d’une ressource téléchargée. Si l’URL d’origine contenait des données supplémentaires, telles que des chaînes de recherche ou des ancres, ou si l’appel a été redirigé, l’URL retournée diffère de l’url d’origine. L’application doit transmettre une mémoire tampon, dimensionnée en octets, qui est suffisamment grande pour contenir l’URL retournée en caractères larges.
WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS
Prend un BOOL et ne peut être défini qu’un handle de session. Elle se propage uniquement aux handles créés à partir du handle de session une fois que l’option a été définie. Si la valeur est TRUE, cette option entraîne en dernier recours l’utilisation d’informations d’identification globales du serveur qui ont été poussées vers le bas à partir de WinInet. La valeur par défaut de cette option est FALSE. Cette option nécessite la clé de Registre HKLM\Software\Microsoft\Windows\CurrentVersion\Internet Settings! ShareCredsWithWinHttp. Cette clé de Registre n’est pas présente par défaut. Lorsqu’il est défini, WinINet envoie les informations d’identification à WinHTTP. Chaque fois que WinHttp reçoit un défi d’authentification et s’il n’y a pas d’informations d’identification définies sur le handle actuel, il utilise les informations d’identification fournies par WinINet.
WINHTTP_OPTION_USE_SESSION_SCH_CRED
Permet de définir des informations d’identification uniques à utiliser par défaut pour tous les points de terminaison au sein de la session au lieu d’avoir des informations d’identification par défaut par point de terminaison. Cela peut améliorer les performances en réduisant la surcharge de gestion des informations d’identification. Notez que ces informations d’identification par défaut n’auront aucun effet lorsqu’un certificat client est fourni explicitement.
WINHTTP_OPTION_USER_AGENT
Définit ou récupère la chaîne de l’agent utilisateur sur les handles fournis par WinHttpOpen et utilisés dans les fonctions WinHttpSendRequest suivantes, tant qu’elle n’est pas remplacée par un en-tête ajouté par WinHttpAddRequestHeaders ou WinHttpSendRequest. Lors de la récupération d’un agent utilisateur, l’application doit passer une mémoire tampon, dimensionnée en octets, qui est suffisamment grande pour contenir l’URL retournée en caractères larges. Lorsque vous définissez l’agent utilisateur, la taille de la mémoire tampon correspond à la longueur de la chaîne, en caractères, plus la terminaison NULL .
WINHTTP_OPTION_USERNAME
Définit ou récupère une chaîne qui contient le nom d’utilisateur.
WINHTTP_OPTION_WEB_SOCKET_CLOSE_TIMEOUT
Définit l’heure, en millisecondes, pendant laquelle WinHttpWebSocketClose doit attendre pour terminer la négociation de fermeture. La valeur par défaut est 10 secondes.
WINHTTP_OPTION_WEB_SOCKET_KEEPALIVE_INTERVAL
Définit l’intervalle, en millisecondes, pour envoyer un paquet keep-alive via la connexion. L’intervalle par défaut est de 30 000 (30 secondes). L’intervalle minimal est de 15000 (15 secondes). L’utilisation de WinHttpSetOption pour définir une valeur inférieure à 15 000 retourne avec ERROR_INVALID_PARAMETER.
Notes
La valeur par défaut pour WINHTTP_OPTION_WEB_SOCKET_KEEPALIVE_INTERVAL est lue à partir de HKLM:\SOFTWARE\Microsoft\WebSocket\KeepaliveInterval. Si une valeur n’est pas définie, la valeur par défaut de 30000 est utilisée. Il n’est pas possible d’avoir un intervalle de conservation inférieur à 15 000 millisecondes.
WINHTTP_OPTION_WEB_SOCKET_RECEIVE_BUFFER_SIZE
Définit ou récupère un DWORD qui spécifie la taille de mémoire tampon de réception à utiliser sur les connexions WebSocket.
WINHTTP_OPTION_WEB_SOCKET_SEND_BUFFER_SIZE
Définit ou récupère un DWORD qui spécifie la taille de mémoire tampon d’envoi à utiliser sur les connexions WebSocket.
WINHTTP_OPTION_WORKER_THREAD_COUNT
Définit une valeur entière longue non signée qui spécifie le nombre de threads de travail que le pool de threads doit utiliser pour les achèvements asynchrones. La valeur par défaut de cette option est zéro, ce qui spécifie que le nombre de threads de travail est égal au nombre de processeurs sur le système. Cette option ne peut être définie que sur un handle HINTERNETNULL avant qu’une opération asynchrone ne se produise. Cette option ne peut être définie qu’une seule fois.
S’applique à : Windows 7 et versions ultérieures ; Windows Server 2008 R2 et versions ultérieures.
WINHTTP_OPTION_WRITE_BUFFER_SIZE
Cette option est déconseillée ; elle n’a aucun effet.
Notes
Le tableau suivant répertorie les indicateurs d’option en spécifiant les handles sur lesquels ils peuvent agir, s’ils peuvent être interrogés et définis, et le type de données utilisé. Un « X » indique que l’indicateur d’option est valide pour une utilisation avec la fonction ou le handle, tandis qu’un « - » spécifie que l’indicateur d’option n’est pas valide.
Si vous tentez de définir ou d’interroger un indicateur d’option sur une version de Windows où elle n’est pas prise en charge, ERROR_WINHTTP_INVALID_OPTION.
| Indicateur d’option et type de données | Handle de session | Handle de demande | Option de requête | Option Set | Version minimale de Windows |
|---|---|---|---|---|---|
| WINHTTP_OPTION_ASSURED_NON_BLOCKING_CALLBACKS BOOL |
X | - | - | X | - |
| WINHTTP_OPTION_AUTOLOGON_POLICY DWORD |
- | X | - | X | - |
| WINHTTP_OPTION_BACKGROUND_CONNECTIONS DWORD |
X | - | - | X | Windows 10 version 21H1 |
| WINHTTP_OPTION_CALLBACK LPVOID |
X | X | X | X | - |
| WINHTTP_OPTION_CLIENT_CERT_CONTEXT CERT_CONTEXT |
- | X | - | X | Windows Vista |
| WINHTTP_OPTION_CLIENT_CERT_ISSUER_LIST SecPkgContext_IssuerListInfoEx |
- | X | X | - | Windows Vista |
| WINHTTP_OPTION_CODEPAGE DWORD |
X | - | - | X | - |
| WINHTTP_OPTION_CONFIGURE_PASSPORT_AUTH DWORD |
X | - | - | X | - |
| WINHTTP_OPTION_CONNECT_RETRIES DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_CONNECT_TIMEOUT DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_CONNECTION_INFO WINHTTP_CONNECTION_INFO |
- | X | X | - | - |
| WINHTTP_OPTION_CONNECTION_STATS_V0 TCP_INFO_v0 |
- | X | X | - | Windows 10 version 1903 |
| WINHTTP_OPTION_CONNECTION_STATS_V1 TCP_INFO_v1 |
- | X | X | - | Windows 10 version 2004 |
| WINHTTP_OPTION_CONTEXT_VALUE DWORD_PTR |
X | X | X | X | - |
| WINHTTP_OPTION_DECOMPRESSION DWORD |
X | X | - | X | Windows 8.1 |
| WINHTTP_OPTION_DISABLE_CERT_CHAIN_BUILDING BOOL |
X | - | - | X | Windows 10 version 21H1 |
| WINHTTP_OPTION_DISABLE_FEATURE DWORD |
- | X | - | X | - |
| WINHTTP_OPTION_DISABLE_SECURE_PROTOCOL_FALLBACK BOOL |
X | - | - | X | Windows 10 version 1903 |
| WINHTTP_OPTION_DISABLE_STREAM_QUEUE BOOL |
X | X | - | X | Windows 10 version 1809 |
| WINHTTP_OPTION_ENABLE_FEATURE DWORD |
* | * | - | X | - |
| WINHTTP_OPTION_ENABLE_HTTP_PROTOCOL DWORD |
X | X | - | X | Windows 10 version 1607 |
| WINHTTP_OPTION_ENABLE_HTTP2_PLUS_CLIENT_CERT_CONTEXT BOOL |
X | - | - | X | Windows 10 version 21H1 |
| WINHTTP_OPTION_ENABLETRACING DWORD |
- | - | X | X | - |
| WINHTTP_OPTION_ENCODE_EXTRA BOOL |
X | X | - | X | Windows 10 version 1803 |
| WINHTTP_OPTION_EXPIRE_CONNECTION N/A |
- | X | - | X | Windows 10 version 1903 |
| WINHTTP_OPTION_EXTENDED_ERROR DWORD |
X | X | X | - | - |
| WINHTTP_OPTION_FIRST_AVAILABLE_CONNECTION BOOL |
X | - | - | X | Windows 10 version 21H1 |
| WINHTTP_OPTION_GLOBAL_PROXY_CREDS WINHTTP_CREDS |
X | X | - | X | - |
| WINHTTP_OPTION_GLOBAL_SERVER_CREDS WINHTTP_CREDS_EX |
X | X | - | X | - |
| WINHTTP_OPTION_HANDLE_TYPE DWORD |
X | X | X | - | - |
| WINHTTP_OPTION_HTTP_PROTOCOL_REQUIRED BOOL |
X | X | - | X | Windows 10 version 1903 |
| WINHTTP_OPTION_HTTP_PROTOCOL_USED DWORD |
- | X | X | - | Windows 10 version 1607 |
| WINHTTP_OPTION_HTTP_VERSION HTTP_VERSION_INFO |
X | X | X | X | - |
| WINHTTP_OPTION_HTTP2_KEEPALIVE DWORD |
X | - | - | X | Windows 10 version 21H1 |
| WINHTTP_OPTION_HTTP2_PLUS_TRANSFER_ENCODING BOOL |
X | X | - | X | Windows 10 version 21H1 |
| WINHTTP_OPTION_IGNORE_CERT_REVOCATION_OFFLINE BOOL |
- | X | - | X | Windows 10 version 2004 |
| WINHTTP_OPTION_IPV6_FAST_FALLBACK BOOL |
X | - | - | X | Windows 10 version 1903 |
| WINHTTP_OPTION_IS_PROXY_CONNECT_RESPONSE BOOL |
X | X | X | - | - |
| WINHTTP_OPTION_MAX_CONNS_PER_1_0_SERVER DWORD |
X | - | X | X | - |
| WINHTTP_OPTION_MAX_CONNS_PER_SERVER DWORD |
X | - | X | X | - |
| WINHTTP_OPTION_MAX_HTTP_AUTOMATIC_REDIRECTS DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_MAX_HTTP_STATUS_CONTINUE DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_MAX_RESPONSE_DRAIN_SIZE DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_MAX_RESPONSE_HEADER_SIZE DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_PARENT_HANDLE HINTERNET |
X | X | X | - | - |
| WINHTTP_OPTION_PASSPORT_COBRANDING_TEXT LPWSTR |
- | X | X | - | - |
| WINHTTP_OPTION_PASSPORT_COBRANDING_URL LPWSTR |
- | X | X | - | - |
| WINHTTP_OPTION_PASSPORT_RETURN_URL LPVOID |
- | X | X | - | - |
| WINHTTP_OPTION_PASSPORT_SIGN_OUT LPVOID |
X | - | - | X | - |
| WINHTTP_OPTION_PASSWORD LPWSTR |
- | X | X | X | - |
| WINHTTP_OPTION_PROXY WINHTTP_PROXY_INFO |
X | X | X | X | - |
| WINHTTP_OPTION_PROXY_PASSWORD LPWSTR |
- | X | X | X | - |
| WINHTTP_OPTION_PROXY_SPN_USED LPWSTR |
- | X | X | - | - |
| WINHTTP_OPTION_PROXY_USERNAME LPWSTR |
- | X | X | X | - |
| WINHTTP_OPTION_READ_BUFFER_SIZE DWORD |
- | X | X | X | - |
| WINHTTP_OPTION_RECEIVE_PROXY_CONNECT_RESPONSE BOOL |
X | X | - | X | - |
| WINHTTP_OPTION_RECEIVE_RESPONSE_TIMEOUT DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_RECEIVE_TIMEOUT DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_REDIRECT_POLICY DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_REJECT_USERPWD_IN_URL BOOL |
- | X | - | X | - |
| WINHTTP_OPTION_REQUEST_PRIORITY DWORD |
- | X | X | X | - |
| WINHTTP_OPTION_REQUEST_STATS WINHTTP_REQUEST_STATS |
- | X | X | - | Windows 10 version 1903 |
| WINHTTP_OPTION_REQUEST_TIMES WINHTTP_REQUEST_TIMES |
- | X | X | - | Windows 10 version 1903 |
| WINHTTP_OPTION_REQUIRE_STREAM_END BOOL |
X | X | - | X | Windows 10 version 21H1 |
| WINHTTP_OPTION_RESOLUTION_HOSTNAME LPWSTR |
- | X | - | X | Windows 10 version 21H1 |
| WINHTTP_OPTION_RESOLVE_TIMEOUT DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_SECURE_PROTOCOLS DWORD |
X | - | - | X | - |
| WINHTTP_OPTION_SECURITY_CERTIFICATE_STRUCT WINHTTP_CERTIFICATE_INFO |
- | X | X | - | - |
| WINHTTP_OPTION_SECURITY_FLAGS DWORD |
- | X | X | X | - |
| WINHTTP_OPTION_SECURITY_INFO WINHTTP_SECURITY_INFO |
- | X | X | - | Windows 10 version 2004 |
| WINHTTP_OPTION_SECURITY_KEY_BITNESS DWORD |
- | X | X | - | - |
| WINHTTP_OPTION_SEND_TIMEOUT DWORD |
X | X | X | X | - |
| WINHTTP_OPTION_SERVER_CBT SecPkgContext_Bindings* |
- | X | X | - | - |
| WINHTTP_OPTION_SERVER_CERT_CHAIN_CONTEXT CERT_CHAIN_CONTEXT |
- | X | X | - | Windows 10 version 2004 |
| WINHTTP_OPTION_SERVER_CERT_CONTEXT CONTEXTE CERT |
- | X | X | - | - |
| WINHTTP_OPTION_SERVER_SPN_USED LPWSTR |
- | X | X | - | - |
| WINHTTP_OPTION_SPN DWORD |
- | X | - | X | - |
| WINHTTP_OPTION_STREAM_ERROR_CODE DWORD |
- | X | X | - | Windows 10 version 21H1 |
| WINHTTP_OPTION_TCP_FAST_OPEN BOOL |
X | - | - | X | Windows 10 version 2004 |
| WINHTTP_OPTION_TCP_KEEPALIVE tcp_keepalive |
X | - | - | X | Windows 10 version 2004 |
| WINHTTP_OPTION_TLS_FALSE_START BOOL |
X | - | - | X | Windows 10 version 2004 |
| WINHTTP_OPTION_TLS_PROTOCOL_INSECURE_FALLBACK BOOL |
X | - | - | X | Windows 10 version 21H1 |
| WINHTTP_OPTION_UNLOAD_NOTIFY_EVENT HINTERNET |
X | - | - | X | - |
| WINHTTP_OPTION_UNSAFE_HEADER_PARSING DWORD |
- | X | - | X | - |
| WINHTTP_OPTION_UPGRADE_TO_WEB_SOCKET N/A |
- | X | - | X | - |
| WINHTTP_OPTION_URL LPWSTR |
- | X | X | - | - |
| WINHTTP_OPTION_USE_GLOBAL_SERVER_CREDENTIALS BOOL |
X | X | - | X | - |
| WINHTTP_OPTION_USER_AGENT LPWSTR |
X | - | X | X | - |
| WINHTTP_OPTION_USERNAME LPWSTR |
- | X | X | X | - |
| WINHTTP_OPTION_WEB_SOCKET_CLOSE_TIMEOUT DWORD |
- | - | X | X | - |
| WINHTTP_OPTION_WEB_SOCKET_KEEPALIVE_INTERVAL DWORD |
- | - | X | X | - |
| WINHTTP_OPTION_WEB_SOCKET_RECEIVE_BUFFER_SIZE DWORD |
X | X | X | X | Windows 8.1 |
| WINHTTP_OPTION_WEB_SOCKET_SEND_BUFFER_SIZE DWORD |
X | X | X | X | Windows 8.1 |
| WINHTTP_OPTION_WORKER_THREAD_COUNT DWORD |
- | - | - | X | - |
| WINHTTP_OPTION_WRITE_BUFFER_SIZE DWORD |
- | X | X | X | - |
Notes
Pour Windows XP et Windows 2000, consultez Exigences au moment de l’exécution.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows XP, Windows 2000 Professionnel avec SP3 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2003, Windows 2000 Server avec SP3 [applications de bureau uniquement] |
| Composant redistribuable | WinHTTP 5.0 et Internet Explorer 5.01 ou version ultérieure sur Windows XP et Windows 2000. |
| En-tête | Winhttp.h |
Voir aussi
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour