IXMLHTTPRequest2 ::SetProperty, méthode (msxml6.h)

Article
08/25/2023

Définit une propriété sur une requête HTTP sortante.

Syntaxe

HRESULT SetProperty(
  [in] XHR_PROPERTY eProperty,
  [in] ULONGLONG    ullValue
);

Paramètres

[in] eProperty

Les valeurs suivantes sont valides :

Value	Signification
XHR_PROP_NO_CRED_PROMPT	Supprime les invites automatiques pour les informations d’identification utilisateur
XHR_PROP_NO_AUTH	Supprime l’authentification que la pile HTTP effectue pour le compte de l’application
XHR_PROP_TIMEOUT	Définit toutes les valeurs de délai d’expiration sur la valeur donnée par ullValue, en millisecondes.
XHR_PROP_NO_DEFAULT_HEADERS	Supprime l’ajout d’en-têtes par défaut à la requête HTTP.
XHR_PROP_REPORT_REDIRECT_STATUS	Provoque l’appel de la pile HTTP à la méthode OnHeadersAvailable avec une redirection intermédiaire status code. La méthode OnHeadersAvailable sera appelée à nouveau pour des redirections supplémentaires et la destination finale status code.
XHR_PROP_NO_CACHE	Supprime les lectures et écritures du cache pour la requête HTTP. Cette propriété est prise en charge par l’interface IXMLHTTPRequest3 .
XHR_PROP_EXTENDED_ERROR	Provoque la pile HTTP pour fournir à HRESULTS le code d’erreur Win32 sous-jacent à la méthode OnError en cas de défaillance. Cette propriété est prise en charge par l’interface IXMLHTTPRequest3 .
XHR_PROP_QUERY_STRING_UTF8	Entraîne l’encodage de la chaîne de requête en UTF-8 au lieu d’ACP pour la requête HTTP. Cette propriété est prise en charge par l’interface IXMLHTTPRequest3 .
XHR_PROP_IGNORE_CERT_ERRORS	Supprime certaines erreurs de certificat. Cette propriété est prise en charge par l’interface IXMLHTTPRequest3 .

[in] ullValue

Spécifie le nombre de millisecondes que l’application attend avant d’expirer.

Valeur	Signification
XHR_PROP_NO_CRED_PROMPT	Ce paramètre peut être l’une des valeurs du type d’énumération XHR_CRED_PROMPT défini dans le fichier d’en-tête Msxml6.h . XHR_CRED_PROMPT_ALL si l’invite d’informations d’identification doit être activée (par défaut). XHR_CRED_PROMPT_NONE si l’invite d’informations d’identification doit être désactivée. XHR_CRED_PROMPT_PROXY si l’invite d’informations d’identification doit uniquement être activée pour l’authentification proxy.
XHR_PROP_NO_AUTH	Ce paramètre peut être l’une des valeurs du type d’énumération XHR_AUTH défini dans le fichier d’en-tête Msxml6.h . XHR_AUTH_ALL si l’authentification est activée (par défaut). XHR_AUTH_NONE si l’authentification est désactivée. XHR_AUTH_PROXY si l’authentification doit être activée uniquement pour l’authentification proxy.
XHR_PROP_TIMEOUT	Nombre de millisecondes (jusqu’à 0xFFFFFFFF) que l’application attend avant d’expirer.
XHR_PROP_NO_DEFAULT_HEADERS	FALSE(0x0) pour activer l’ajout d’en-têtes par défaut (par défaut). TRUE(0x1) pour désactiver l’ajout d’en-têtes par défaut.
XHR_PROP_REPORT_REDIRECT_STATUS	FALSE(0x0) pour ne pas signaler les status de redirection (valeur par défaut). TRUE(0x1) pour signaler les status de redirection.
XHR_PROP_NO_CACHE	FALSE(0x0) pour activer la mise en cache (par défaut). TRUE(0x1) pour désactiver la mise en cache.
XHR_PROP_EXTENDED_ERROR	FALSE(0x0) pour ne pas fournir d’erreurs étendues (par défaut). TRUE(0x1) pour fournir des erreurs étendues .
XHR_PROP_QUERY_STRING_UTF8	FALSE(0x0) pour ne pas encoder la chaîne de requête en UTF-8 (par défaut). TRUE(0x1) pour encoder la chaîne de requête en UTF-8.
XHR_PROP_IGNORE_CERT_ERRORS	FALSE(0x0) pour ne pas ignorer les erreurs de certificat (par défaut). TRUE(0x1) pour ignorer les erreurs de certificat.

Valeur retournée

Renvoie S_OK en cas de réussite.

Remarques

La méthode SetProperty sur l’interface IXMLHTTPRequest2 est étendue sur l’interface IXMLHTTPRequest3 avec de nouvelles propriétés pour prendre en charge de nouveaux scénarios :

XHR_PROP_NO_CACHE : supprime les lectures et écritures du cache pour la requête HTTP.
XHR_PROP_EXTENDED_ERROR : provoque la pile HTTP pour fournir à HRESULTS le code d’erreur Win32 sous-jacent à la méthode OnError en cas de défaillance.
XHR_PROP_QUERY_STRING_UTF8 : entraîne l’encodage de la chaîne de requête en UTF-8 au lieu de la requête ACP pour HTTP.
XHR_PROP_IGNORE_CERT_ERRORS : supprime certaines erreurs de certificat de serveur.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau \| Applications UWP],MSXML 6.0 et versions ultérieures
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	msxml6.h