XHR_PROPERTY enumeration

Defines properties that you can assign to an outgoing HTTP request by calling the SetProperty method.

Syntax


typedef enum _XHR_PROPERTY { 
  XHR_PROP_NO_CRED_PROMPT          = 0,
  XHR_PROP_NO_AUTH                 = 1,
  XHR_PROP_TIMEOUT                 = 2,
  XHR_PROP_NO_DEFAULT_HEADERS      = 0x3,
  XHR_PROP_REPORT_REDIRECT_STATUS  = 0x4,
  XHR_PROP_NO_CACHE                = 0x5,
  XHR_PROP_EXTENDED_ERROR          = 0x6,
  XHR_PROP_QUERY_STRING_UTF8       = 0x7,
  XHR_PROP_IGNORE_CERT_ERRORS      = 0x8
} XHR_PROPERTY;

Constants

XHR_PROP_NO_CRED_PROMPT

Sets a flag in the HTTP request that suppresses automatic prompts for credentials.

XHR_PROP_NO_AUTH

Sets a flag in the HTTP request that configures the HTTP request that disables authentication for the request.

XHR_PROP_TIMEOUT

Sets the connect, send, and receive timeouts for HTTP socket operations.

Note  This value will not affect the timeout behavior of the entire request process.

XHR_PROP_NO_DEFAULT_HEADERS

Suppresses adding default headers to the HTTP request.

XHR_PROP_REPORT_REDIRECT_STATUS

Causes the HTTP stack to call the OnHeadersAvailable callback method with an interim redirecting status code. The OnHeadersAvailable will be called again for additional redirects and the final destination status code.

XHR_PROP_NO_CACHE

Suppresses cache reads and writes for the HTTP request.

XHR_PROP_EXTENDED_ERROR

Causes the HTTP stack to provide HRESULTS with the underlying Win32 error code to the OnError callback method in case of failure.

XHR_PROP_QUERY_STRING_UTF8

Causes the query string to be encoded in UTF8 instead of ACP for HTTP request.

XHR_PROP_IGNORE_CERT_ERRORS

Suppresses certain certificate errors.

Requirements

Minimum supported client

Windows 8 [desktop apps | Windows Store apps]

Minimum supported server

Windows Server 2012 [desktop apps | Windows Store apps]

Minimum supported phone

Windows Phone 8.1 [Windows Phone Silverlight 8.1 and Windows Runtime apps]

Version

MSXML 6.0 and later

Header

Msxml6.h

IDL

Msxml6.idl

See also

OnError
OnHeadersAvailable
SetProperty

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.