SetProperty Method (Windows 8, C++)

  • Article

Sets a property on an outgoing HTTP request.

C/C++ Syntax

HRESULT SetProperty(
    XHR_PROPERTY eProperty,
    ULONGLONG ullValue);

Parameters

  • eProperty [in]
    One of the following values indicating the property being set:

    1. XHR_PROP_NO_CRED_PROMPT: Controls automatic prompts for user credentials

    2. XHR_PROP_NO_AUTH: Controls authentication that the HTTP stack performs on behalf of the application

    3. XHR_PROP_TIMEOUT: Sets timeout values.

  • ullValue [in]
    A long integer containing the value to which you are setting the property given by eProperty. Possible values for each property are:

    1. XHR_PROP_NO_CRED_PROMPT

      0: Prompts for user credentials. This value is the default.

      1: Suppresses prompts for user credentials.

    2. XHR_PROP_NO_AUTH

      0: Turns on authentication. This value is the default.

      1: Suppresses authentication.

    3. XHR_PROP_NO_CRED_PROMPT

      An unsigned long integer specifying the timeout value, in milliseconds, for network operations.

C/C++ Return Values

  • S_OK
    The value returned if successful.

Remarks

You must set properties after a successful call to IXMLHTTPRequest2::Open and before you call IXMLHTTPRequest2::Send. Properties are valid for the duration of the request.

Versioning

Implemented in: MSXML 6.0

Applies to

IXMLHTTPRequest2 (Windows 8)

See Also

Concepts

Open Method (IXMLHTTPRequest2, Windows 8)

Send Method (IXMLHTTPRequest2, Windows 8)

Other Resources

XHR_PROPERTY