WinHttpRequestOption, énumération

Article
06/13/2023

L’énumération WinHttpRequestOption inclut des options qui peuvent être définies ou récupérées pour la session Microsoft Windows HTTP Services (WinHTTP) actuelle.

Syntaxe

typedef enum WinHttpRequestOption { 
  WinHttpRequestOption_UserAgentString,
  WinHttpRequestOption_URL,
  WinHttpRequestOption_URLCodePage,
  WinHttpRequestOption_EscapePercentInURL,
  WinHttpRequestOption_SslErrorIgnoreFlags,
  WinHttpRequestOption_SelectCertificate,
  WinHttpRequestOption_EnableRedirects,
  WinHttpRequestOption_UrlEscapeDisable,
  WinHttpRequestOption_UrlEscapeDisableQuery,
  WinHttpRequestOption_SecureProtocols,
  WinHttpRequestOption_EnableTracing,
  WinHttpRequestOption_RevertImpersonationOverSsl,
  WinHttpRequestOption_EnableHttpsToHttpRedirects,
  WinHttpRequestOption_EnablePassportAuthentication,
  WinHttpRequestOption_MaxAutomaticRedirects,
  WinHttpRequestOption_MaxResponseHeaderSize,
  WinHttpRequestOption_MaxResponseDrainSize,
  WinHttpRequestOption_EnableHttp1_1,
  WinHttpRequestOption_EnableCertificateRevocationCheck
} WinHttpRequestOption;

Constantes

WinHttpRequestOption_UserAgentString

Définit ou récupère un VARIANT qui contient la chaîne de l’agent utilisateur .

WinHttpRequestOption_URL

Récupère un VARIANT qui contient l’URL de la ressource. Cette valeur est en lecture seule ; vous ne pouvez pas définir l’URL à l’aide de cette propriété. L’URL ne peut pas être lue tant que la méthode Open n’est pas appelée. Cette option est utile pour vérifier l’URL une fois la méthode Send terminée afin de vérifier qu’une redirection s’est produite.

WinHttpRequestOption_URLCodePage

Définit ou récupère un VARIANT qui identifie la page de codes pour la chaîne d’URL. La valeur par défaut est la page de codes UTF-8. La page de codes est utilisée pour convertir la chaîne d’URL Unicode, passée dans la méthode Open , en une représentation sous forme de chaîne codée sur un octet.

WinHttpRequestOption_EscapePercentInURL

Définit ou récupère un VARIANT qui indique si les caractères de pourcentage dans la chaîne d’URL sont convertis en séquence d’échappement. La valeur par défaut de cette option est VARIANT_TRUE qui spécifie tous les caractères non sécurisés de l’American National Standards Institute (ANSI), à l’exception du symbole de pourcentage, sont convertis en séquence d’échappement.

WinHttpRequestOption_SslErrorIgnoreFlags

Définit ou récupère un variant qui indique les erreurs de certificat de serveur qui doivent être ignorées. Il peut s’agir d’une combinaison d’un ou plusieurs des indicateurs suivants.

Error	Valeur
Autorité de certification inconnue ou racine non approuvée	0x0100
Utilisation incorrecte	0x0200
Nom commun (CN) non valide	0x1000
Date ou expiration du certificat non valide	0x2000

La valeur par défaut de cette option dans la version 5.1 de WinHTTP est zéro, ce qui entraîne l’absence d’erreurs ignorées. Dans les versions antérieures de WinHTTP, le paramètre par défaut était 0x3300, ce qui a entraîné l’ignorer par défaut de toutes les erreurs de certificat de serveur.

WinHttpRequestOption_SelectCertificate

Définit un VARIANT qui spécifie le certificat client qui est envoyé à un serveur pour l’authentification. Cette option indique l’emplacement, le magasin de certificats et l’objet d’un certificat client délimité par des barres obliques inverses. Pour plus d’informations sur la sélection d’un certificat client, consultez SSL dans WinHTTP.

WinHttpRequestOption_EnableRedirects

Définit ou récupère un VARIANT qui indique si les demandes sont automatiquement redirigées lorsque le serveur spécifie un nouvel emplacement pour la ressource. La valeur par défaut de cette option est VARIANT_TRUE pour indiquer que les demandes sont automatiquement redirigées.

WinHttpRequestOption_UrlEscapeDisable

Définit ou récupère un VARIANT qui indique si les caractères non sécurisés dans les composants de chemin d’accès et de requête d’une URL sont convertis en séquences d’échappement. La valeur par défaut de cette option est VARIANT_TRUE, qui spécifie que les caractères du chemin d’accès et de la requête sont convertis.

WinHttpRequestOption_UrlEscapeDisableQuery

Définit ou récupère un VARIANT qui indique si les caractères non sécurisés dans le composant de requête de l’URL sont convertis en séquences d’échappement. La valeur par défaut de cette option est VARIANT_TRUE, qui spécifie que les caractères de la requête sont convertis.

WinHttpRequestOption_SecureProtocols

Définit ou récupère un VARIANT qui indique quels protocoles sécurisés peuvent être utilisés. Cette option sélectionne les protocoles acceptables pour le client. Le protocole est négocié lors de l’établissement d’une liaison SSL (Secure Sockets Layer). Il peut s’agir d’une combinaison d’un ou plusieurs des indicateurs suivants.

Protocol	Valeur
SSL 2.0	0x0008
SSL 3.0	0x0020
TLS (Transport Layer Security) 1.0	0x0080

La valeur par défaut de cette option est 0x0028, ce qui indique que SSL 2.0 ou SSL 3.0 peuvent être utilisés. Si cette option est définie sur zéro, le client et le serveur ne sont pas en mesure de déterminer un protocole de sécurité acceptable et l’envoi suivant génère une erreur.

WinHttpRequestOption_EnableTracing

Définit ou récupère un VARIANT qui indique si le suivi est actuellement activé. Consultez également Collecter des traces WinHTTP.

WinHttpRequestOption_RevertImpersonationOverSsl

Contrôle si l’objet WinHttpRequest rétablit temporairement l’emprunt d’identité du client pendant la durée des opérations d’authentification par certificat SSL. Le paramètre par défaut de l’objet WinHttpRequest est TRUE. Définissez cette option sur FALSE pour conserver l’emprunt d’identité lors de l’exécution d’opérations d’authentification de certificat.

WinHttpRequestOption_EnableHttpsToHttpRedirects

Contrôle si WinHTTP autorise ou non les redirections. Par défaut, toutes les redirections sont automatiquement suivies, à l’exception de celles qui sont transférées d’une URL sécurisée (https) vers une URL non sécurisée (http). Définissez cette option sur TRUE pour activer les redirections HTTPS vers HTTP.

WinHttpRequestOption_EnablePassportAuthentication

Active ou désactive la prise en charge de l’authentification Passport. Par défaut, la prise en charge automatique de l’authentification Passport est désactivée ; définissez cette option sur TRUE pour activer la prise en charge de l’authentification Passport.

WinHttpRequestOption_MaxAutomaticRedirects

Définit ou récupère 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 bloquer le client WinHTTP après un grand nombre de redirections.