Énumération WinHttpRequestOption

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).

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 pour vérifier que toute redirection s’est produite.

WinHttpRequestOption_URLCodePage

Définit ou récupère un VARIANT qui identifie la page de codes de 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 d’un octet.

WinHttpRequestOption_EscapePercentInURL

Définit ou récupère un VARIANT qui indique si des 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 de l’American National Standards Institute (ANSI) non sécurisés, sauf que le symbole de pourcentage est converti en séquence d’échappement.

WinHttpRequestOption_SslErrorIgnoreFlags

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

Erreur	Valeur
Autorité de certification inconnue ou racine non approuvée	0x0100
Mauvaise utilisation	0x0200
Nom commun non valide (CN)	0x1000
Date ou certificat non valide expiré	0x2000

La valeur par défaut de cette option dans la version 5.1 de WinHTTP est égale à 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 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 requêtes 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 des caractères non sécurisés dans le chemin d’accès et les composants 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 des 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é pendant l’établissement d’une liaison SSL (Secure Sockets Layer). Il peut s’agir d’une combinaison d’un ou plusieurs des indicateurs suivants.

Protocole	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 peut être utilisé. 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 les 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 a la valeur TRUE. Définissez cette option sur FALSE pour conserver l’emprunt d’identité lors de l’exécution d’opérations d’authentification par certificat.

WinHttpRequestOption_EnableHttpsToHttpRedirects

Contrôle si WinHTTP autorise ou non les redirections. Par défaut, toutes les redirections sont automatiquement suivies, sauf 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 https vers les redirections 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 en suivant un grand nombre de redirections.