IXMLHttpRequest::open Method

This document describes the proposed design to be delivered with Internet Explorer 5, and differs slightly from the implementation provided with this Internet Explorer 5 Beta. We encourage you to evaluate these features and to send us your feedback. Please note that these features are subject to change.

Initializes a Microsoft.XMLHTTP request, and specifies the method, URL, and authentication information for the request.

Syntax

HRESULT open(
    BSTR bstrMethod,
    BSTR bstrUrl,
    VARIANT bAsync,
    VARIANT bstrUser,
    VARIANT bstrPassword);

Parameters

bstrMethod

[in] HTTP method used to open the connection, such as "PUT" or "PROPFIND".

bstrUrl

[in] Requested URL. This must be an absolute URL, such as "http://Myserver/Mypath/".

bAsync

[in] Indicator as to whether the call is asynchronous. The default is true (the call blocks until it returns). This parameter must be a Boolean (True or False).

bstrUser

[in] Name of the user for authentication. If this parameter is NULL ("") or missing and the site requires authentication, the component displays a logon window.

bstrPassword

[in] Password for authentication. This parameter is ignored if the user parameter is NULL or missing.

Return Value

Returns S_OK if successful, or an error code otherwise.

Remarks

The values of the request headers, request body, response headers, and response body must be cleared before calling this method.