Método IXMLHTTPRequest2::SetProperty (msxml6.h)

  • Artículo

Establece una propiedad en una solicitud HTTP saliente.

Sintaxis

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

Parámetros

[in] eProperty

Valores válidos son:

Valor Significado
XHR_PROP_NO_CRED_PROMPT
 Suprime las solicitudes automáticas de credenciales de usuario.
XHR_PROP_NO_AUTH
 Suprime la autenticación que realiza la pila HTTP en nombre de la aplicación.
XHR_PROP_TIMEOUT
 Establece todos los valores de tiempo de espera en el valor proporcionado por ullValue, en milisegundos.
XHR_PROP_NO_DEFAULT_HEADERS
 Suprime la adición de encabezados predeterminados a la solicitud HTTP.
XHR_PROP_REPORT_REDIRECT_STATUS
 Hace que la pila HTTP llame al método OnHeadersAvailable con un código de estado de redireccionamiento provisional. Se llamará de nuevo al método OnHeadersAvailable para redireccionamientos adicionales y el código de estado de destino final.
XHR_PROP_NO_CACHE
 Suprime las lecturas y escrituras de la memoria caché para la solicitud HTTP.

Esta propiedad es compatible con la interfaz IXMLHTTPRequest3 .
XHR_PROP_EXTENDED_ERROR
 Hace que la pila HTTP proporcione HRESULTS con el código de error win32 subyacente al método OnError en caso de error.

Esta propiedad es compatible con la interfaz IXMLHTTPRequest3 .
XHR_PROP_QUERY_STRING_UTF8
Hace que la cadena de consulta se codifique en UTF-8 en lugar de ACP para la solicitud HTTP.

Esta propiedad es compatible con la interfaz IXMLHTTPRequest3 .
XHR_PROP_IGNORE_CERT_ERRORS
 Suprime determinados errores de certificado.

Esta propiedad es compatible con la interfaz IXMLHTTPRequest3 .

[in] ullValue

Especifica el número de milisegundos que la aplicación espera antes de que se agote el tiempo de espera.

Valor Significado
XHR_PROP_NO_CRED_PROMPT
 Este parámetro puede ser uno de los valores del tipo de enumeración XHR_CRED_PROMPT definido en el archivo de encabezado Msxml6.h .
  • XHR_CRED_PROMPT_ALL si se debe habilitar la solicitud de credenciales (valor predeterminado).
  • XHR_CRED_PROMPT_NONE si se debe deshabilitar la solicitud de credenciales.
  • XHR_CRED_PROMPT_PROXY si la solicitud de credenciales solo debe habilitarse para la autenticación de proxy.
XHR_PROP_NO_AUTH
 Este parámetro puede ser uno de los valores del tipo de enumeración XHR_AUTH definido en el archivo de encabezado Msxml6.h .
  • XHR_AUTH_ALL si la autenticación está habilitada (valor predeterminado).
  • XHR_AUTH_NONE si la autenticación está deshabilitada.
  • XHR_AUTH_PROXY si la autenticación solo debe habilitarse para la autenticación de proxy.
XHR_PROP_TIMEOUT
Número de milisegundos, hasta 0xFFFFFFFF, que la aplicación espera antes de que se agote el tiempo de espera.
XHR_PROP_NO_DEFAULT_HEADERS
  • FALSE(0x0) para habilitar la adición de encabezados predeterminados (valor predeterminado).
  • TRUE(0x1) para deshabilitar la adición de encabezados predeterminados.
XHR_PROP_REPORT_REDIRECT_STATUS
  • FALSE(0x0) para no notificar el estado de redireccionamiento (valor predeterminado).
  • TRUE(0x1) para notificar el estado de redirección.
XHR_PROP_NO_CACHE
  • FALSE(0x0) para habilitar el almacenamiento en caché (valor predeterminado).
  • TRUE(0x1) para deshabilitar el almacenamiento en caché.
XHR_PROP_EXTENDED_ERROR
  • FALSE(0x0) para no proporcionar errores extendidos (valor predeterminado).
  • TRUE(0x1) para proporcionar errores extendidos.
XHR_PROP_QUERY_STRING_UTF8
  • FALSE(0x0) para no codificar la cadena de consulta en UTF-8 (valor predeterminado).
  • TRUE(0x1) para codificar la cadena de consulta en UTF-8.
XHR_PROP_IGNORE_CERT_ERRORS
  • FALSE(0x0) para no omitir los errores de certificado (valor predeterminado).
  • TRUE(0x1) para omitir los errores de certificado.

Valor devuelto

Devuelve S_OK si se realiza correctamente.

Comentarios

El método SetProperty de la interfaz IXMLHTTPRequest2 se extiende en la interfaz IXMLHTTPRequest3 con nuevas propiedades para admitir nuevos escenarios:

  • XHR_PROP_NO_CACHE: suprime las lecturas y escrituras de caché para la solicitud HTTP.
  • XHR_PROP_EXTENDED_ERROR: hace que la pila HTTP proporcione HRESULTS con el código de error win32 subyacente al método OnError en caso de error.
  • XHR_PROP_QUERY_STRING_UTF8: hace que la cadena de consulta se codifique en UTF-8 en lugar de ACP para la solicitud HTTP.
  • XHR_PROP_IGNORE_CERT_ERRORS: suprime determinados errores de certificado de servidor.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP],MSXML 6.0 y versiones posteriores
Servidor mínimo compatible Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino Windows
Encabezado msxml6.h

Consulte también

IXMLHTTPRequest2

IXMLHTTPRequest3

OnHeadersAvailable

Abrir

XHR_PROPERTY (enumeración)